Linux

Where Does Self-Hosted Grist Store Documents?

Grist self-hosted workbook files and sharing access database paths on Linux servers for team use cases.

Last updated

Grist keeps workbooks as SQLite files under a persist root. The default container path is /persist with docs, snapshots, and landing.db inside. Each document folder holds its own history.

Settings arrive as environment variables with a .env file beside compose. That file holds domain and session secrets. Back up the persist volume with the env file. Documents without landing.db lose sharing metadata. Formulas mirror spreadsheet syntax closely. Access rules gate rows per user login. Imports handle CSV cleanly.

Where Grist stores this, by platform

Linux
/persist/docs (Grist data)

Workbook storage with docs, snapshots, and landing.db inside. Mount a volume here to survive updates. Copy with Grist stopped for consistency.

Linux
/persist/landing.db

Home database with users, workspaces, and sharing state. Back up with docs and snapshots. Recreate invites when this file is lost.

Frequently asked questions

what do i back up for a Grist move

Copy the persist folder with landing.db for single node restores. Documents sit in docs with SQLite files. Snapshots beside them capture history. All three restore the site.

where is Grist data in Docker

Run docker volume ls to find the grist persist volume, then inspect for mountpoints. The container path stays /persist. Compose prefixes the volume name with the project folder.

Notice an outdated path? Let us know.