Everyday running

Everyday checks#

Logs#

• The server edition: sudo agentx logs server (or runner, whatsapp, caddy, updater). sudo agentx support-bundle gathers versions, settings without secrets and log lines for OXS support, never data.
• Lumate Local: the logs folder, see Lumate Local.

An agent's full run, with every tool call and result, is on the agent's Runs tab, or from the run pill in a thread.

Each service keeps at most 30 MB of log (three files of 10 MB; the oldest goes first), so logs never fill the disk. The server logs what happens, not every request: the runner's and the open pages' frequent checks leave no lines.

Memory. The server edition bounds each service: the server 2 GB, the runner 2 GB, WhatsApp 512 MB, Caddy 256 MB and the updater 512 MB, so one runaway process cannot take the machine. With more than two runs at once (RUNNER_SLOTS), give the runner more (RUNNER_MEMORY=4g; SERVER_MEMORY for the server) in /opt/agentx/.env, then sudo docker compose --project-directory /opt/agentx -f /opt/agentx/compose.yml up -d runner.

Backups#

The server edition backs itself up: every day, before every update and when asked (Settings → Backups, or agentx backup), with a copy to a bucket if you want one, and agentx restore puts a backup back. See The server edition. A backup needs as much free disk space as the data, plus 512 MB: with less, it is refused before anything is written (and an update waits, changing nothing), so a backup never fills the disk. Lumate Local keeps daily backups by itself, see Lumate Local.

Updating#

The server edition updates itself from its channel (Settings → Updates: automatic installs in the maintenance window, or Update now), backs up first and goes back by itself when the new version does not start. From the shell: agentx update, agentx update --bundle <offline bundle>, agentx rollback. See The server edition. Lumate Local updates itself too, see Lumate Local.

Troubleshooting#

Sign-in and setup#

Licence#

Agents#

Voice and phone#

WhatsApp#

Office browser#

Command line#

On the server edition, run these in /opt/agentx with sudo:

docker compose exec server python -m app.cli create-user <username> [--admin]
docker compose exec server python -m app.cli reset-password <username>
docker compose exec server python -m app.cli create-runner-key <company-slug> <name>

reset-password sets a new password and prints it once: sign in with it, then choose your own in Settings → Your account. Every other session of that person ends. It is also how an address gets back to its owner when an account was made for it by someone else: reset it, give the password to the real person, and they choose their own.