{"name":"Peergos: A P2P Secure File Storage, Social Network, and Application Protocol","description":"Peergos is a peer-to-peer, secure platform designed for private file storage, social networking, and application hosting. It emphasizes user control over data, offering end-to-end encryption and fine-grained access control. Built on a decentralized architecture, Peergos aims to create a private web experience where users are protected from surveillance and data tracking.","github":"https://github.com/Peergos/Peergos","url":"https://osrepos.com/repo/peergos-peergos","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/peergos-peergos","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/peergos-peergos.md","json":"https://osrepos.com/repo/peergos-peergos.json","topics":["Java","P2P","Decentralized","Encryption","Privacy","File Storage","Social Network","IPFS"],"keywords":["Java","P2P","Decentralized","Encryption","Privacy","File Storage","Social Network","IPFS"],"stars":null,"summary":"Peergos is a peer-to-peer, secure platform designed for private file storage, social networking, and application hosting. It emphasizes user control over data, offering end-to-end encryption and fine-grained access control. Built on a decentralized architecture, Peergos aims to create a private web experience where users are protected from surveillance and data tracking.","content":"## Introduction\n\nPeergos is a groundbreaking peer-to-peer, secure platform that redefines file storage, social networking, and application protocols. It champions the vision of a \"private web\" where end-users maintain absolute control over their data, free from surveillance and tracking. At its core, Peergos provides an encrypted global filesystem with fine-grained access control, designed to resist data content or friendship graph surveillance. Key features include a secure messenger, an encrypted email client, and a completely private social network, all built on strong cryptographic principles. The name Peergos, derived from the Greek word ?????? (Pyrgos) meaning stronghold or tower, phonetically connects to its peer-to-peer nature, emphasizing its commitment to user data security.\n\nFor more in-depth information, explore the [official Peergos website](https://peergos.org/){:target=\"_blank\"} and its comprehensive [tech book](https://book.peergos.org){:target=\"_blank\"}.\n\n## Installation\n\nGetting started with Peergos involves running a local instance, which can connect to an existing Peergos account or host a new one.\n\n**Prerequisites:**\nYou will need Java Development Kit (JDK) version 21 or higher installed.\n\n**Running Locally (Client Mode):**\n1.  Download the latest `Peergos.jar` release from the [official releases page](https://peergos.net/public/peergos/releases){:target=\"_blank\"}.\n2.  Execute the daemon:\n    bash\n    java -jar Peergos.jar daemon\n    \n    This will store Peergos data in `~/.peergos` by default. You can then access the web interface and log in via `http://localhost:8000`. In this mode, your local instance proxies writes to your home server and caches accessed blocks.\n\n**Self-Hosting (Server Mode):**\nTo run your own Peergos home-server, which is ideal for a publicly routable and always-on machine:\n1.  Download the `Peergos.jar` as above.\n2.  Run with a token generation flag:\n    bash\n    java -jar Peergos.jar daemon -generate-token true\n    \n    This will provide a single-use signup token for creating new accounts on your server.\n\nDocker images are also available for easier deployment:\nbash\ndocker pull ghcr.io/peergos/web-ui:master\ndocker run --volume $(PEERGOS_PATH):/opt/peergos/data ghcr.io/peergos/web-ui:master daemon -listen-host 0.0.0.0 -public-domain $YOUR_DOMAIN_NAME -log-to-console true\n\n\n## Examples\n\nPeergos offers a robust command-line interface (CLI) for various operations, including an interactive shell.\n\n**Interactive Shell:**\nConnect to a Peergos server and manage your files and social interactions:\nbash\njava -jar Peergos.jar shell\n\nYou will be prompted for the server address, username, and password. Once logged in, you can use commands like `help` to see available options or `put local_path remote_path` for uploading files.\n\n**Native File Access:**\nPeergos supports mounting your encrypted storage space natively using FUSE (Filesystem in Userspace) on Linux/macOS or WinFsp on Windows, and also provides a WebDAV bridge for accessing files with any WebDAV compatible client.\n\n## Why Use Peergos?\n\nPeergos is built on the principle, \"Control your data, control your destiny.\" It offers a compelling alternative to traditional centralized services by prioritizing user privacy and security through a decentralized architecture.\n\n**Key Advantages:**\n*   **Ultimate Privacy and Security:** End-to-end encryption ensures that your data content and metadata, including friendship graphs, are protected from surveillance. Private keys never leave your client device.\n*   **Decentralized Control:** Store files in a peer-to-peer network without a central node, making it resilient to disruption and censorship. Users own their data and decide where it is stored.\n*   **Self-Hostable:** Easily run your own Peergos server, gaining complete control over your storage space and communication platform.\n*   **Secure Web Applications:** Load and run web apps directly from Peergos within a sandbox, preventing data exfiltration and allowing user-granted permissions.\n*   **Post-Quantum Resistance:** Files not shared with other users are designed to be resistant to quantum computer-based attacks, leveraging hashing and symmetric encryption.\n*   **Trustless Servers:** Your data and metadata remain secure even if your server is compromised, as encryption happens client-side.\n\nPeergos is actively audited for security, with reports available on its [website](https://peergos.org/posts/security-audit-2024){:target=\"_blank\"} and [GitHub repository](https://github.com/Peergos/Peergos/tree/master/audits){:target=\"_blank\"}.\n\n## Links\n\n*   **GitHub Repository:** [https://github.com/Peergos/Peergos](https://github.com/Peergos/Peergos){:target=\"_blank\"}\n*   **Official Website:** [https://peergos.org/](https://peergos.org/){:target=\"_blank\"}\n*   **Tech Book:** [https://book.peergos.org](https://book.peergos.org){:target=\"_blank\"}\n*   **Try the Demo:** [https://peergos.net/#%7B%22secretLink%22:true%2c%22link%22:%22#6MDZhRRPT4ugkJuUfcWtaZodN5QYzkZKJtHpDHomFJrVhNSZysiFYimpgtcA2F/6MDZhRRPT4ugkJuUfcRzRbPpFimcBNJx2N9TJDnL4W3ETYhwdsWdvgCkXkwipF/FCYSFhpQ1xD2cydr6CFQ6UwFkgB82pWReAUzKVDxe4KA/5Pf7SvCG1mMtui2aPd9F3SH2wdwsPro1GxTa7VfxkWrj9XQGAUB%22%2c%22open%22:true%2c%22path%22:%22/demo/%22%7D](https://peergos.net/#%7B%22secretLink%22:true%2c%22link%22:%22#6MDZhRRPT4ugkJuUfcWtaZodN5QYzkZKJtHpDHomFJrVhNSZysiFYimpgtcA2F/6MDZhRRPT4ugkJuUfcRzRbPpFimcBNJx2N9TJDnL4W3ETYhwdsWdvgCkXkwipF/FCYSFhpQ1xD2cydr6CFQ6UwFkgB82pWReAUzKVDxe4KA/5Pf7SvCG1mMtui2aPd9F3SH2wdwsPro1GxTa7VfxkWrj9XQGAUB%22%2c%22open%22:true%2c%22path%22:%22/demo/%22%7D){:target=\"_blank\"}\n*   **Matrix Chat Room:** [https://matrix.to/#/#peergos-chat:matrix.org](https://matrix.to/#/#peergos-chat:matrix.org){:target=\"_blank\"}","metrics":{"detailViews":3,"githubClicks":4},"dates":{"published":null,"modified":"2025-10-20T23:01:22.000Z"}}