Files
proton-drive-linux/docs
nvrl a888e0bb28 fix(gui): run the CAPTCHA page in its own process (B195)
On secureblue, WebKit cannot start the sandbox for the verification page:
bubblewrap is kept from the journal socket, xdg-dbus-proxy fails, and
WebKit ends its process with g_error. The webview lived in pdfs-app, so
the whole app crashed after the sign-in (#29).

- gui: `pdfs-app --human-verification` shows the page in its own window,
  reads the URL on stdin and prints the token on stdout; its logs go to
  stderr
- gui: a child that dies or fails without a token ends the sign-in with a
  message that the page could not be opened, instead of "cancelled"
- i18n: translate the new message in every catalog
- docs: B195 in the bug ledger, the cause and a one-time workaround in
  TROUBLESHOOTING.md, the child process in ARCHITECTURE.md, changelog
2026-10-08 10:25:14 +02:00
..

Documentation

For users

Page What it covers
Installation Packages, building from source, first sign-in, updating and uninstalling
User guide My files, available offline, synced folders, sync issues and conflicts, Photos, sharing, Trash and versions, Computers, the search launcher, the tray
Command-line reference Every pdfs command, grouped by task, and scripting with --json
Configuration config.json, environment variables, file locations, the systemd service
Troubleshooting Diagnosing problems, common symptoms, starting over, reporting a bug
Recovering on a new computer What survives a lost machine and how to restore your synced folders
Changelog What changed in each release

For contributors

Page What it covers
Development guide Building, running and debugging from source; common changes; releasing
Architecture Crates, the local tree, read and write paths, the queue, the sync engine, the control protocol, threads, threat model
Testing Unit tests, simulation runs and the FUSE acceptance suite
Translating Adding and updating translations
Roadmap Planned work and verification still owed
Bug ledger Every tracked defect with its analysis and status

Also see CONTRIBUTING.md and SECURITY.md in the repository root.