Installation

Getting Selu running takes just a few minutes. Use the installer command below and Selu will prepare Docker Compose, generate your local settings, and start automatically.

Prerequisites

Before you begin, make sure you have the following:

Docker & Docker Compose

Selu runs in containers. You’ll need Docker Engine 24+ and Docker Compose v2+. Get Docker if you don’t have it yet.

System resources

At minimum, 2 GB of RAM and 5 GB of disk space. If you plan to run local language models, you’ll want significantly more — 16 GB RAM and a GPU are recommended.

Other requirements:

• A supported OS: Linux, macOS, or Windows (via WSL2)
• An open port (default: 3000) for the web dashboard
• An API key from a language model provider (OpenAI, Anthropic, etc.) — or a local model if you prefer

Install in one command

bash <(curl -fsSL https://selu.bot/install.sh)

You can choose a channel with:

bash <(curl -fsSL https://selu.bot/install.sh) --channel dev

Available channels are stable (default), dev, and nightly.

Release channels

• stable: semver-tagged releases (for example v0.4.2). Recommended for most users.
• dev: latest main branch builds.
• nightly: daily automated builds.

In the Selu UI, you can change this later in System Updates.

Verify your installation

Check that services are running

docker compose ps

You should see all services in a running state with no restarts.

Open the dashboard

Visit http://localhost:3000 in your browser. You should see the Selu welcome screen and be prompted to create your first account.

Check logs if something went wrong

docker compose logs -f

Look for errors related to port conflicts, missing environment variables, or resource limits.

Common issues

Problem	Solution
Port 3000 is already in use	Re-run the installer with --port or update SELU__SERVER__PORT in your .env, then restart with docker compose up -d
Containers keep restarting	Check logs with docker compose logs. This usually means insufficient memory.
Can’t reach the dashboard	Make sure your firewall allows traffic on the configured port. On macOS, check Docker Desktop’s resource settings.

Updating Selu

To update to the latest version:

From the Selu UI, open System Updates and click Update now. If an update fails health checks, Selu keeps rollback information and offers a Rollback action.

Selu compares image digests from https://selu.bot/api/releases/selu before applying updates. You can still run manual updates with:

docker compose pull
docker compose up -d

Your data is stored in Docker volumes, so updates won’t erase your agents, conversations, or settings.

Next steps

Selu is running — nice! Head to the Quick Start guide to configure a language model and install your first agent.