FUSE mounts over a non-empty folder without complaint, so files already in the My files folder were hidden under the mount: not uploaded, and back only once the service stopped, so they looked deleted (#67, B277). - pdfs-core: new `mountpoint` module. `not_empty` lists what is in a folder (hidden entries count); `mounted_fs_type` moves here from the CLI so the daemon can use it. `MountFailure` gains an optional `not_empty` field, which older readers ignore. - pdfs-fuse: `mount_with` checks the folder before the root fetch and before any worker starts. A dead mount is cleared first; one of our own live mounts is left to `spawn_session`, as before. - pdfs-cli: `cmd_daemon` records the folder in the failure record. The refusal backs off and retries like any mount failure, so emptying the folder is enough. - pdfs-gui: the status pages explain the refusal, and a dialog offers to open the folder or choose another one, once per run of failures. The folder picker refuses a folder with files in it. Translated in all catalogs. Docs: BUGS (B277), CHANGELOG, FAQ, TROUBLESHOOTING, CONFIGURATION.
5.5 KiB
FAQ
Short answers to common questions, with links to the details.
- Is this an official Proton app?
- If I delete a file in
~/ProtonDrive, is it deleted on Proton Drive? - Online only, available offline or synced folder: which do I want?
- Does it work offline?
- How do I get updates?
- Why is there no tray icon?
- What is stored unencrypted on my computer?
- Does it send telemetry?
- Can I use it on several computers?
- Can I continue a backup from Windows or macOS?
- Can I run it on a server without a desktop?
- Which architectures and languages are supported?
- How do I report a bug?
Is this an official Proton app?
No. It is an independent, open-source client, not affiliated with or endorsed by Proton AG. It uses a Rust port of Proton's own Drive SDK, and everything stays end-to-end encrypted. It has had no independent security audit. See the security model.
If I delete a file in ~/ProtonDrive, is it deleted on Proton Drive?
Yes. ~/ProtonDrive is your Proton Drive, not a copy. A deleted file moves to the Proton Drive
Trash, and you can restore it from Trash in the app or the web. See Trash.
Stopping the service is not the same: once the service stops, ~/ProtonDrive is just an empty
folder, and your files stay on Proton Drive. Keep it empty: the service does not open My files
over a folder with files in it, because it would hide them. See
My files does not open: the folder is not empty.
Online only, available offline or synced folder: which do I want?
- Online only for most of your Drive. Files take no space until you open them.
- Available offline for files in
~/ProtonDriveyou need without a connection. - Synced folder for a folder that lives on this computer, such as
~/Documents, and should be backed up.
Getting started compares them side by side.
Does it work offline?
Yes, for files that are on this computer: available-offline files, synced folders, and recently opened files still in the cache. You can also create, rename, move and delete files offline. The changes are queued and sent when the connection is back. See Changes waiting for Proton Drive.
How do I get updates?
Through your package manager. The Fedora COPR repository, the AUR and the Nix flake get every
release, so dnf upgrade, your AUR helper or a flake update brings it. The .deb has to be
downloaded again for each release. To be told about new releases, turn on Check for updates
in Preferences. The app never updates itself. See Installation → Updating.
Why is there no tray icon?
GNOME needs the AppIndicator extension to show tray icons. If you hid the icon from its own menu, turn it back on under Preferences → General → Appearance.
What is stored unencrypted on my computer?
To show your files, the client decrypts them on this computer. Recently opened files, files kept offline, changes waiting to upload, and the names of your files and folders are stored without extra encryption. Use full-disk or home-folder encryption. The security model has the full list.
Does it send telemetry?
No. The client connects only to Proton, and, if you turn them on, to OpenFreeMap for the street map in Photos and to GitHub to check for updates. See Network connections.
Can I use it on several computers?
Yes. Each computer has its own backup in Proton Drive, and two or more computers can also sync the same folders. See Syncing several computers.
Can I continue a backup from Windows or macOS?
Yes. On the Computers page, choose Move to This Computer… on the old computer. Its folders move into this computer's backup on Proton Drive, without uploading anything again. See Moving another computer's backup here.
Can I run it on a server without a desktop?
Yes, with pdfs daemon or pdfs mount. It still needs a Secret Service provider such as GNOME
Keyring or KeePassXC to hold the session. See
Headless and server use.
Which architectures and languages are supported?
Release packages are for x86_64. Other architectures can build from source.
The app, tray and launcher are available in English, German, Spanish, French, Italian, Dutch, Polish and Brazilian Portuguese. Translating explains how to add a language.
How do I report a bug?
Run pdfs diagnose, then open an issue
with what Reporting a problem lists. Report security
problems privately, as described in SECURITY.md.