aulayai/runtime repository overview

⁠Aulay runtime

Run the Aulay⁠ runtime in Docker and add the machine to your fleet. Agents you start in Aulay then run inside this container, with git, Node 22, pnpm, Claude Code and a headless Chromium for browser previews ready to use.

Full tutorial: https://aulay.ai/guides/docker⁠

One command pulls this image, pairs it and starts it:

curl -fsSL https://market.aulay.ai/docker.sh | sh

⁠Quick start

Pair the container with your account. You only do this once per volume. It prints a sign-in link: open it in any browser, then paste the one-time code back into the terminal.

docker run -it --rm -v aulay-runtime:/home/aulay --hostname my-docker aulayai/runtime login

Then run it in the background:

docker run -d --name aulay-runtime --restart unless-stopped \
  -v aulay-runtime:/home/aulay --hostname my-docker aulayai/runtime

my-docker appears under Computers in Aulay within a few seconds.

⁠Docker Compose

services:
  runtime:
    image: aulayai/runtime:latest
    container_name: aulay-runtime
    hostname: my-docker
    restart: unless-stopped
    volumes:
      - aulay-runtime:/home/aulay

volumes:
  aulay-runtime:
    name: aulay-runtime

docker compose run --rm -it runtime login   # first time only
docker compose up -d

⁠Staying up to date

The image doesn't contain the runtime itself. Each time the container starts, it downloads the latest runtime into the volume, or updates the copy already there. While the container runs, the runtime updates itself whenever it's idle. Pulling a newer image only refreshes the OS, Node and Claude Code:

docker pull aulayai/runtime && docker rm -f aulay-runtime && docker run -d ...   # same command as above

⁠Settings

⁠Good to know

• Volume: /home/aulay holds the pairing, the runtime, repos, worktrees and ~/.claude. Keep it to keep the computer. Deleting it means pairing again as a new computer.
• Network: outbound HTTPS/WSS to *.aulay.ai (and *.aulay.io for older installs) only. Don't publish any ports.
• Architecture: linux/amd64 and linux/arm64, both native (Apple Silicon, Graviton, Raspberry Pi 64-bit).
• Unpair: docker exec -it aulay-runtime aulay-entrypoint.sh unpair this, then delete the volume.