Skip to content

docs: document Docker user permissions and persistent storage#597

Merged
camathieu merged 1 commit intomasterfrom
docs/docker-permissions-585
Feb 17, 2026
Merged

docs: document Docker user permissions and persistent storage#597
camathieu merged 1 commit intomasterfrom
docs/docker-permissions-585

Conversation

@camathieu
Copy link
Member

Restructures the Docker deployment guide to document user permissions, persistent storage options, and common pitfalls.

Changes

  • Persistent storage — document named volumes (recommended) and bind mounts as two clear options, with the plikd.cfg configuration required for both
  • User permissions — document that the container runs as plik (UID=1000/GID=1000) and bind-mounted host directories must be writable by that UID
  • Config path warning — callout that plikd.cfg paths must reference container paths, not host paths
  • Setup verification — upload → restart → confirm cycle to catch misconfigurations early
  • Docker Compose — modernized example (named volume, docker compose v2 CLI, removed deprecated version key)
  • Image tags — added preview tag, clarified version examples
  • Removed "Redeploying with a Custom Image" section (internal workflow, not user-facing)

Closes #585

- Restructure Docker deployment guide for clarity
- Add persistent storage section with named volume (recommended) and bind mount options
- Document container user (UID=1000/GID=1000) and host permission requirements
- Add config path warning (plikd.cfg must reference container paths)
- Add setup verification steps
- Modernize Docker Compose example (named volume, docker compose v2)
- Update available image tags (add preview tag)

Closes #585
@camathieu camathieu force-pushed the docs/docker-permissions-585 branch from 9106d94 to d2805b3 Compare February 17, 2026 09:50
@camathieu camathieu merged commit 6262625 into master Feb 17, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

500 Internal Server error with Podman quadlet and bind mount (works with Podman volume)

1 participant