nooks
GitHubInstall
Operations

Back up

The export is the database, so there is nothing to restore from — only a file to copy back.

Nooks does not invent a backup format. On SQLite the export is the database, copied while the instance keeps running.

That matters more than it sounds. A hand-written exporter is a second description of the schema, and the way it fails is quiet: one table gets added, nobody adds it to the exporter, and the backups are incomplete for months before anybody finds out.

Taking one

Settings → About → Export everything, as an admin. What downloads is a real SQLite file.

Or over the API, with an access token:

curl -H "Authorization: Bearer $NOOKS_TOKEN" \
  -o nooks-backup.db https://nooks.example/api/v1/backup

Putting one back

Stop the instance, put the file where --data points, and start it again. There is no importer because nothing was ever converted.

On postgres

Use pg_dump. Nooks does not wrap it — it is better than anything we would write, and it is already on the machine running your database.

pg_dump --format=custom --file=nooks-backup.dump "$NOOKS_DSN"

On this page