Install Stackarr

Stackarr is distributed as a Docker image. The same Compose setup works on a Linux server, NAS, or desktop with a current Docker runtime.

Before you begin

You need:

• Docker Engine or Docker Desktop with Compose v2
• permission to run Docker commands
• a folder for Stackarr's Compose file and local data
• media and download folders that Docker can access

Install

mkdir -p stackarr && cd stackarr
curl -fsSL https://stackarr.app/docker-compose.yml -o docker-compose.yml
docker compose --profile stackarr up -d app

Open http://127.0.0.1:7777/setup.

Stackarr creates a .stackarr folder beside the Compose file:

Set custom storage paths in the setup flow before starting the full stack.

Stackarr uses Portless links by default for stable, port-free app addresses. If Portless is not available on the Docker host, choose localhost in any app's Settings panel and Stackarr will use its normal published port instead.

Choose how to finish setup

For a chat-led setup, connect an agent with the admin profile and ask it to show a dry-run before applying anything:

docker exec app /app/bin/stackarr mcp config codex --profile admin

For a manual setup, continue in the browser. Both paths use the same actions and save the same settings.

Check the container

docker compose ps app
docker compose logs --tail=100 app

Continue to Docker configuration for storage, networking, updates, and the Docker socket security model.