pcloudcc-lneely is an independent fork of the inactive pcloudcom/console-client
pcloudcc is simple linux console client for pCloud cloud storage derived from the console-client developed by pCloud. This version is independently maintained by me, whose only affiliation with pCloud is as a user of their services. Due credit goes to Anton Titov, Ivan Stoev, and pCloud.
The target operating system and platform for this program is linux/amd64, and has been reported to work on linux/aarch64. Program behavior on 32-bit architectures is considered undefined.
I aim to support as many distributions as possible. I maintain a package for AUR and Nix. I do not plan on providing or maintaining any other packages, but encourage anyone interested in doing so for their own distributions.
| Distribution | FUSE |
|---|---|
| Debian trixie | 2.x |
| Debian trixie | 3.x |
| Arch Linux (rolling) | 3.x latest |
| Fedora 41 | 3.x |
| Fedora (latest) | 3.x latest |
| Debian forky | 3.18+ |
| Slackware 15 | 3.10.5 |
All configurations require mbedTLS 3.x. Runtime mount testing was performed manually on FUSE 2 (libfuse 2.9.x), FUSE 3 (libfuse3 3.10.5), and FUSE 3.18+ (Debian forky container).
My code audits are best-effort, and I make security enhancements as I identify problems. However, I do not promise that this program is free of even older and well-known security vulnerabilities. Therefore, I recommend using this program only on a trusted single-user system. Security-related code audits and contributions are most welcome!
Contributing: Read this if you’re interested in
helping out. Short version: do your best to write good code, be
courteous to maintainers, and most importantly: have fun!
Building: Read this if you’re not sure how to build
pcloudcc. For most users, make and make install are enough.
mbedtls 3.x migration notes: Read this if you use an
older distribution such as debian:bookworm and encounter build problems.
Device Validation Guide: Read this if you’re
running pcloudcc and encounter device validation-related errors.
Usage Guide: Read this if you’re unsure how to start using
pcloudcc.
Log Management Guide: Read this to configure log rotation,
cache size limits, and custom log paths. To set up automatic log rotation, copy
pcloudcc.logrotate to /etc/logrotate.d/pcloudcc.
pcloudcc-service: Container-based
systemd service for running pcloudcc in userspace with podman. Includes multi-stage
Dockerfile that builds pcloudcc from source and Quadlet systemd unit for automated
background syncing.