central-backup: no-passphrase instructions are incorrect

Open Beginner friendly
#2,132 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
1/5
Estimated time
Under an hour
Newbie friendliness
75/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
python
Domain
documentation

Research direction

Read the central-backup page at https://docs.getodk.org/central-backup/ and check the two no-passphrase instructions quoted in the issue. Confirm how the commands behave without a passphrase, then update the instructions so they proceed without one; done when both examples accurately describe the no-passphrase steps.

Written by the indexing model from the issue text.

Description

https://docs.getodk.org/central-backup/

It will ask for the backup passphrase. Just press the enter key if you didn't use any passphrase.

This throws an error 1 rather than proceeding without passphrase.

Similarly:

openssl enc -d -chacha20 -pbkdf2 < /path/to/central-backup-2026-04-01T11:22:33.456Z.pgdump.enc.bin 2>/dev/null | head -c 5

I think they both need -pass "pass:" added if there is no passphrase

Dominant language
Python
Stars
58
Forks
161
Avg merge
20h 51m
Merged PRs (30d)
2

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from getodk/docs

All issues in getodk/docs

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.