# Peergos: A P2P Secure File Storage, Social Network, and Application Protocol

This repository profile is provided by osrepos.com, an open source repository discovery platform.

Source: osrepos.com
Repository profile: https://osrepos.com/repo/peergos-peergos
Generated for open source discovery and AI-assisted research.

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
OSRepos URL: https://osrepos.com/repo/peergos-peergos

## 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.

## Topics

- Java
- P2P
- Decentralized
- Encryption
- Privacy
- File Storage
- Social Network
- IPFS

## Repository Information

Last analyzed by OSRepos: Tue Oct 21 2025 00:01:22 GMT+0100 (Western European Summer Time)
Detail views: 3
GitHub clicks: 4

## Safety Notice

OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything.

## Content

## Introduction

Peergos 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.

For 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"}.

## Installation

Getting started with Peergos involves running a local instance, which can connect to an existing Peergos account or host a new one.

**Prerequisites:**
You will need Java Development Kit (JDK) version 21 or higher installed.

**Running Locally (Client Mode):**
1.  Download the latest `Peergos.jar` release from the [official releases page](https://peergos.net/public/peergos/releases){:target="_blank"}.
2.  Execute the daemon:
    bash
    java -jar Peergos.jar daemon
    
    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.

**Self-Hosting (Server Mode):**
To run your own Peergos home-server, which is ideal for a publicly routable and always-on machine:
1.  Download the `Peergos.jar` as above.
2.  Run with a token generation flag:
    bash
    java -jar Peergos.jar daemon -generate-token true
    
    This will provide a single-use signup token for creating new accounts on your server.

Docker images are also available for easier deployment:
bash
docker pull ghcr.io/peergos/web-ui:master
docker 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


## Examples

Peergos offers a robust command-line interface (CLI) for various operations, including an interactive shell.

**Interactive Shell:**
Connect to a Peergos server and manage your files and social interactions:
bash
java -jar Peergos.jar shell

You 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.

**Native File Access:**
Peergos 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.

## Why Use Peergos?

Peergos 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.

**Key Advantages:**
*   **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.
*   **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.
*   **Self-Hostable:** Easily run your own Peergos server, gaining complete control over your storage space and communication platform.
*   **Secure Web Applications:** Load and run web apps directly from Peergos within a sandbox, preventing data exfiltration and allowing user-granted permissions.
*   **Post-Quantum Resistance:** Files not shared with other users are designed to be resistant to quantum computer-based attacks, leveraging hashing and symmetric encryption.
*   **Trustless Servers:** Your data and metadata remain secure even if your server is compromised, as encryption happens client-side.

Peergos 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"}.

## Links

*   **GitHub Repository:** [https://github.com/Peergos/Peergos](https://github.com/Peergos/Peergos){:target="_blank"}
*   **Official Website:** [https://peergos.org/](https://peergos.org/){:target="_blank"}
*   **Tech Book:** [https://book.peergos.org](https://book.peergos.org){:target="_blank"}
*   **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"}
*   **Matrix Chat Room:** [https://matrix.to/#/#peergos-chat:matrix.org](https://matrix.to/#/#peergos-chat:matrix.org){:target="_blank"}