How to install MyAgens on Linux

MyAgens runs well on Linux, including on a small VPS you leave on around the clock. The installer works across the common distributions.

Requirements

• A modern 64-bit Linux distribution (Debian, Ubuntu, Fedora, Arch, and similar).
• curl and bash (install curl from your package manager if it is missing).
• Permission to install packages (usually sudo).

Install

On a Linux desktop, run:

curl -fsSL https://myagens.com/install.sh | bash -s -- --browser

The terminal installs the dependencies quietly, then a setup page opens in your browser to create your Telegram bot, verify it's you, and connect Claude, with every value checked live before it's saved. The step-by-step lives at myagens.com/install. It asks for your password once up front so the background service can be registered at the end.

Running on a headless server

On a VPS with no desktop there is no browser to open, so use the classic in-terminal wizard, the same command without the flag:

curl -fsSL https://myagens.com/install.sh | bash

MyAgens still gives you the web panel over the local network, and full control from Telegram. Bind the panel to localhost and reach it through an SSH tunnel, or put it behind your own reverse proxy with authentication. Never expose the panel to the open internet without a login in front of it.

Keeping it running

Nothing to do on a systemd distribution: the installer registers the myagens systemd service for you (that is what the password prompt at the start was for), so the fleet comes back on its own after a reboot. Do not add a second unit by hand, two copies polling Telegram split the updates between them. On a distribution with a different init system, the README on GitHub shows what the service needs to run.

Updating

Re-run the install command to update in place. If the service does not come back up, see MyAgens will not start.

Uninstalling

See How to uninstall MyAgens: one command removes the systemd service, then you delete the files at your own pace.