isle/README.md

1.8 KiB

This project is currently in early-access deep-alpha testing phase. Do not rely on it for anything.


Isle

Welcome to Isle's technical documentation. You can find a less technical entrypoint to Isle on the Micropelago website.

Isle runs on a host as a server daemon, and connects to other isle instances to form a peer-to-peer network. Isle networks are completely self-hosted; no third-parties are required for a network to function.

Members of a network are able to build upon the capabilities provided by Isle to host services for themselves and others. These capabilities include:

  • A VPN which enables direct peer-to-peer communication between network members. Even if most hosts in the network are on a private LAN (e.g. their home WiFi network) or have a dynamic IP, they can still communicate directly with each other.

  • An S3-compatible network filesystem. Each member can provide as much storage as they care to, if any. Stored data is sharded and replicated across all hosts that choose to provide storage.

  • A DNS server which provides automatic host discovery within the network.

Every isle daemon is able to create or join multiple independent networks. In this case the networks remain siloed from each other, such that members of one network are unable to access resources or communicate with members of the other.

Getting Started

The following pages will guide you through setup of Isle, joining an existing network, and all other functionality available via the command-line.

Those who want to dive in and contribute to the Isle codebase should check out the Developer Documentation.