Anki Sync Server Container¶

Containerized build of anki-sync-server, the official self-hosted sync server for Anki.

Features¶

Runs the upstream anki-sync-server binary, built from source at a pinned release tag.
Runs as an unprivileged user; PUID/PGID control the ownership of the data volume.
Ships with a Docker/Podman HEALTHCHECK using the binary's built-in --healthcheck flag.

Usage¶

Pull the image¶

podman pull registry.gitlab.com/niclas-zone/ctr/anki:latest
podman pull registry.gitlab.com/niclas-zone/ctr/anki:26.05

Run the server¶

podman run -d \
  --name anki-sync-server \
  -p 8080:8080 \
  -e PUID=1000 \
  -e PGID=1000 \
  -e SYNC_USER1=user:pass \
  -v anki_data:/anki_data \
  registry.gitlab.com/niclas-zone/ctr/anki:latest

Environment variables¶

Variable	Default	Description
`PUID`	`1000`	UID the server runs as; owns `/anki_data`.
`PGID`	`1000`	GID the server runs as; owns `/anki_data`.
`SYNC_BASE`	`/anki_data`	Directory where sync data is stored.
`SYNC_HOST`	`0.0.0.0`	Address the server listens on.
`SYNC_PORT`	`8080`	Port the server listens on.
`SYNC_USER1`	-	`user:pass` credential pair (repeat as `SYNC_USER2`, ... for more accounts).

See the upstream docs for the full list of supported environment variables.

Author¶

Niclas Heinz

Contributing¶

Contributions are welcome! Please open an issue or submit a merge request if you have suggestions or improvements.

License¶

This project is licensed under the MIT License. See LICENSE for full details.