Earthstar has a new specification powered by Willow.
Earthstar v11 is now in beta.
Navigate

Earthstar

Replica Servers

A topology of users chained together by replica servers

Most laptops and phones are not able to connect directly to each other, so we need some third place they can both connect to where share data is held for syncing.

These are called Replica Servers. You can run your own replica server(s) for your community on a small device like a Raspberry Pi, or hosted in the cloud.

Every computer running Earthstar, even replica servers, is a Peer. Replica servers are just Peers like regular users' computers; the only difference is they're online all the time and they have reachable URLs.

Replica servers have no control over user permissions, and there can be many servers running at once for a particular share. This is good for redundancy and reliabilty; ask your friends to run a replica server too! Earthstar works best when the infrastructure is controlled by the people using the share.

Most importantly, replica servers are simple and undemanding. We want to enable people of all skill levels — and schedules — to run replica servers for their friends, families and communities without having to dedicate lots of effort and time to them.

Running your own Replica server

The easy way

Here's the simplest way to start hosting a replica server we've come up with.

Remix on Glitch

This gives you a simple replica server which you can use to sync data between different peers.

The more involved, but still comparatively easy way

If you're comfortable with deploying web services yourself, we've developed a complete framework for creating replica servers which can be extended with new functionality, such as serving content from an Earthstar share over the web.

It comes with a few pre-configured servers for you to use:

These replica servers can be deployed on hosting services like Fly, or even run from home on a Raspberry Pi.

Here's a template for a configurable replica server for Fly.io, with deployment instructions.

In future, we'll have options for one-click self-hosting solutions like Yunohost.

It's also possible to create completely customised replica servers using a selection of extensions. We've tried to make it as easy as possible to create your own extensions, too.

You can find more about the Replica server framework at the replica server framework page and via the API documentation.