Go to file
2024-11-18 21:16:47 +01:00
AppDir Embed default daemon.yml directly in entrypoint 2024-09-24 11:27:54 +02:00
dist/linux Refactor arch package building a bit, to make it easier to test 2024-11-03 15:23:43 +01:00
docs Write a short document on removing hosts from the network 2024-11-12 16:46:35 +01:00
go Implement 'storage remove-allocation' 2024-11-18 21:16:47 +01:00
nix Embed default daemon.yml directly in entrypoint 2024-09-24 11:27:54 +02:00
.gitignore Adjust .gitignore after change to yml 2022-11-05 16:32:26 +01:00
default.nix Add mock of network interface 2024-11-09 23:17:10 +01:00
flake.lock Make sure we can use nix cache for non-cross-compiling 2023-03-25 17:05:29 +01:00
flake.nix Refactor arch package building a bit, to make it easier to test 2024-11-03 15:23:43 +01:00
LICENSE.txt Add AGPLv3 license 2023-08-25 14:16:52 +02:00
README.md Update isle link in README 2024-11-05 11:23:28 +01:00
release.nix Refactor arch package building a bit, to make it easier to test 2024-11-03 15:23:43 +01:00
release.sh Fixes for releasing 2024-07-14 13:56:43 +02:00
shell.nix Add ./go/tests.sh 2024-10-05 21:12:29 +02:00

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.