Skip to content

Docker: recommend mounting the database directory as a named volume#1090

Draft
andig wants to merge 1 commit into
mainfrom
docs/docker-named-volume-wal
Draft

Docker: recommend mounting the database directory as a named volume#1090
andig wants to merge 1 commit into
mainfrom
docs/docker-named-volume-wal

Conversation

@andig

@andig andig commented Jun 15, 2026

Copy link
Copy Markdown
Member

Draft, queued to land with evcc-io/evcc#30903 (sqlite: enable WAL mode).

Adds a tip to the Docker installation page (en + de) clarifying that the /root/.evcc directory must be mounted, never a single evcc.db file, and recommending a named Docker volume.

Why: with WAL enabled, evcc keeps evcc.db-wal and evcc.db-shm next to the database; these sidecar files have to persist together with evcc.db. A named volume keeps them together and lives on the hosts native filesystem, which provides the file locking SQLite needs — bind mounts over network shares (NFS/SMB) or the Docker Desktop virtualized FS (macOS/Windows) can break SQLite locking.

The existing examples already bind-mount the directory (/home/user/.evcc:/root/.evcc), so they keep working; this only adds the explicit guidance and the named-volume recommendation. Kept as a draft so it merges alongside the WAL change rather than ahead of it.

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.

1 participant