skills.rest
resonatehq
resonatehqOFFICIAL
Explore all skills by this author →
Website𝕏@resonatehqioGitHub

resonate-server-deployment

Deploy the Resonate server on Linux with systemd and JWT authentication.

6|Updated Jan 8, 2026
Search Tags:#deployment#jwt#server#linux#systemd#reverse-proxy#resonate
One-click install
npx skills add https://github.com/resonatehq/resonate-skills --skill resonate-server-deployment
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: resonate-server-deployment
Source: https://github.com/resonatehq/resonate-skills/tree/main/resonate-server-deployment
Command: npx skills add https://github.com/resonatehq/resonate-skills --skill resonate-server-deployment

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about resonate-server-deployment

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy a Resonate server on Linux using systemd?▼

To deploy a Resonate server on Linux, install the binary and create a systemd service file to ensure the process restarts reliably and runs under service management.

How do I configure JWT authentication for a Resonate server?▼

Configure JWT authentication by generating an RSA keypair, supplying the public key to the server via the api-auth-public-key flag, and producing client tokens with appropriate role claims.

What's the best way to set up a reverse proxy for external Resonate workers?▼

Configure a reverse proxy to map the server's public address so external workers and clients can successfully reach required callback URLs over the network.

Why does my Resonate worker fail to connect to the server URL?▼

Worker connectivity failures stem from incorrect server-url flags, port conflicts, or reverse proxy misconfiguration; validate network reachability and token-based access to diagnose the issue.

Do I need systemd to run a Resonate server on Linux?▼

Systemd is required for this deployment pattern, as it provides service file creation, automatic restarts, and process management tailored for Linux hosts running Resonate.

How do I generate RSA keys for Resonate JWT tokens?▼

Generate an RSA keypair for JWT authentication, configure the server with the public key, and distribute signed client tokens containing the correct prefix or role claims.

Related Skills

Explore More Software Engineering Skills→
viralcodeviralcode
61

linux-service-triage

Diagnose Linux service failures by analyzing logs, systemd/PM2 status, and Nginx configurations.

Community
Intermediate
resonatehqresonatehq
6

resonate-token-authentication-typescript

Authenticate clients with JWT tokens and authorize access by prefix.

Official
Advanced
aiunlocked1412aiunlocked1412
14

system-admin

Secure Linux VPS servers with SSH hardening, UFW, fail2ban, and Nginx TLS.

Community
Advanced
wimbleroboticswimblerobotics
18

systemd-autostart

Automate boot-time ROS 2 startup with systemd service files.

Community
Advanced