Freika / Freika/dawarich

Backup & Restore Documentation Doesn't Mention Files

Open Beginner friendly
#3,340 1 comment 0 reactions 0 assignees View on GitHub
Dominant language
Ruby
Stars
10.4k
Forks
376
Avg merge
1d 10h
Merged PRs (30d)
151

Description

**OS & Hardware**
Linux

**Version**
1.10.3

**Describe the bug**
The [Backup & Restore | Dawarich](https://dawarich.app/docs/self-hosting/maintenance/backup-and-restore/) documentation talks about backing up the PostgreSQL database but I notice that my installation also has files in `/var/lib/dawarich/`. Notably I have the following files:

- `[12]/[23]/123456....` hex file names.
- `secrets/secret-key-base`
- `imports/watched`

These directories aren't mentioned in the docs at all which leads to concern. One would hope that these are ephemeral and that is why they aren't backed up but if so an explicit callout would make the reader far more confident in this case.

**To Reproduce**
Steps to reproduce the behavior:
1. Read https://dawarich.app/docs/self-hosting/maintenance/backup-and-restore/

**Expected behavior**
The user is correctly and confidently backing up their instance.

Contributor guide

Open the contributing guide

Research direction

Start with the linked Backup & Restore documentation and inspect how the installation uses /var/lib/dawarich/, especially the listed hex files, secrets/secret-key-base, and imports/watched paths. Confirm which paths require backup or are ephemeral, then update the page so users can identify the complete backup requirements and verify the documented guidance.

Written by the indexing model from the issue text.

Assessment

Tech stack
postgresql
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
Half a day
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
68/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.