resonate-server-deployment

What problem does it solve?

Deploying a durable Resonate server for external workers and clients can fail without clear guidance on systemd setup, public URL configuration, JWT authentication, reverse proxying, and common troubleshooting steps; this Skill consolidates those operational tasks into a repeatable deployment pattern.

Core Features & Use Cases

• Installation and service management: Install the Resonate binary, create and manage a systemd service, and ensure the process restarts reliably.
• Public URL and reverse proxy configuration: Configure the server's public address and reverse proxy rules so external workers and clients can reach callback URLs.
• JWT authentication and clients: Generate and deploy RSA keypairs, configure the server with the public key, and produce client tokens with appropriate prefix or role claims.
• Troubleshooting checklist: Diagnose common issues such as authorization failures, port conflicts, database locks, and worker connectivity problems.

Quick Start

Deploy the Resonate server on a Linux host using systemd, set the public server URL for external access, and enable JWT authentication by supplying the server's public key.