Installing Lares
The tested path from an empty server to a running console.
Current status
Lares is experimental alpha software. There is no tagged release yet, only release candidates. The tested path below is exercised against release candidates, and the fresh-server check for rc.11 is still pending. Try it on a disposable server before you connect real accounts.
"Tested path" is not a promise of support: there is no support agreement or response time. See the decision record.
What you need
- A fresh Ubuntu 24.04 x86-64 server with at least 6 GiB of memory and 20 GiB of free disk, root SSH access by key, and ports 80 and 443 free.
- A domain name whose A record points at that server.
- A model-provider API key. The shipped gateway configuration uses an Anthropic API key; a consumer chat subscription does not include API access.
- A Google OAuth client for signing in to the console. Connecting Gmail and Calendar later needs a second client with those scopes.
- Docker with Compose v2, Node.js 24, pnpm 9.15.0,
curlandgiton the server. - Somewhere to keep backups that is not this server: an SFTP host, an S3-compatible bucket or a second disk.
Other Linux distributions and macOS are best-effort: expected to work, not tried.
The tested path
A fresh Ubuntu server and one installer, services/box/ops/install.sh. It checks the machine and your domain before it writes anything, asks four questions (domain, e-mail, name and model key), tests the key with a real call, and offers to start fresh or check a backup. Nothing is built on your server: images are built in CI and pulled by digest from a release file.
The installer stops at the console's "create your first agent" page. You create the agent and talk to it in the console, starting with web chat.
The step-by-step guide, with the exact commands, is in the repository: docs/install.md.
After the install
- Connect doors so agents can reach you on Slack, Telegram or e-mail, and choose where each kind of message goes.
- Learn how approvals work before an agent sends anything.
- Switch on and prove backups before you rely on the installation.
Need help?
Ask in the community Slack. Answers are best effort; there is no promised support. If you get stuck anywhere in the guide, a note saying where is the most useful thing you can send.
Contact Bendik to discuss self-hosting, hosted setup or managed work.