Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 46 additions & 2 deletions docs/content/docs/(getting-started)/docker.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -227,7 +227,13 @@ docker stop spacebot && docker rm spacebot

### One-Click Update

Mount the Docker socket to enable updating directly from the web UI:
Mount a container runtime socket to enable updating directly from the web UI.

- Docker: mount `/var/run/docker.sock`
- Podman (rootful): mount `/run/podman/podman.sock`
- Podman (rootless): mount `${XDG_RUNTIME_DIR}/podman/podman.sock` to `/run/podman/podman.sock` in the container

Docker example:

```yaml
services:
Expand Down Expand Up @@ -271,10 +277,48 @@ curl http://localhost:19898/api/update/check
# Force a fresh check
curl -X POST http://localhost:19898/api/update/check

# Apply update (requires Docker socket)
# Apply update (requires container runtime socket)
curl -X POST http://localhost:19898/api/update/apply
```

### Podman One-Click Update

Set `SPACEBOT_DEPLOYMENT=docker` and mount a Podman socket.

Rootful:

```bash
sudo systemctl enable --now podman.socket

podman run -d \
--name spacebot \
-e ANTHROPIC_API_KEY="sk-ant-..." \
-e SPACEBOT_DEPLOYMENT=docker \
-v spacebot-data:/data \
-v /run/podman/podman.sock:/run/podman/podman.sock \
--security-opt label=disable \
-p 19898:19898 \
ghcr.io/spacedriveapp/spacebot:latest
```

Rootless:

```bash
systemctl --user enable --now podman.socket

podman run -d \
--name spacebot \
-e ANTHROPIC_API_KEY="sk-ant-..." \
-e SPACEBOT_DEPLOYMENT=docker \
-v spacebot-data:/data \
-v ${XDG_RUNTIME_DIR}/podman/podman.sock:/run/podman/podman.sock \
--security-opt label=disable \
-p 19898:19898 \
ghcr.io/spacedriveapp/spacebot:latest
```

On Fedora/RHEL with SELinux enforcing, keep `--security-opt label=disable` when mounting the Podman socket.

## CI / Releases

Images are built and pushed to `ghcr.io/spacedriveapp/spacebot` via GitHub Actions (`.github/workflows/release.yml`).
Expand Down
Loading
Loading