Skip to main content

Installing Apps

srvly doesn't install apps directly. Instead, your AI agent handles the deployment using the information available in the app catalog. There are three ways to send installation instructions to your agent.

Configure a webhook URL in Settings → Agent Integration. On any app install page, click 🤖 Send to agent — the prompt is delivered directly to your agent's chat (Mattermost, Discord, Slack). Optionally set an @mention so the agent is notified.

Method 2: Hosted Skill URL​

Each user has a unique skill URL at:

https://console.srvly.app/api/agent/skill/YOUR_TOKEN

This returns the full agent configuration as raw text. Pass it to your agent with a one-liner:

curl -s https://console.srvly.app/api/agent/skill/YOUR_TOKEN | your-agent --load -

This works in Telegram, Discord, or any platform with message length limits.

Method 3: Manual Copy​

Each app page generates a complete installation prompt. Click Copy and paste it into your agent's chat.

What the Agent Does​

  • Checks port availability on the target server
  • Pulls the correct Docker image
  • Maps ports and configures the firewall
  • Sets up a domain with automatic SSL (Caddy)
  • Mounts volumes for persistent data
  • Registers the installation so it appears in your dashboard

If It Fails​

The agent automatically:

  1. Cleans up any failed containers and partial records
  2. Picks an alternative port if needed
  3. Retries the installation
  4. Reports the result

App Requirements​

Each app page in the catalog lists:

  • Docker image and version
  • Default port
  • Dependencies (PostgreSQL, Redis, etc.)
  • Supported OS versions
  • Links to official documentation and source code