World of Statecraft · Self-Hosting

Run a Node

Host your own instance on your own hardware, keep full custody of your own records, and join a federation that has no center. One command, from a Raspberry Pi to a cloud server.

COMING SOONThis walkthrough is being recorded. If you can script, narrate, animate, or edit, help us produce it.Help Make Our Videos →

Watch the Walkthrough

From an Empty Machine to a Live World

A film of a complete installation, from the first command to a seated world, is in production.

Why Self-Hosting Matters

Whoever Holds the Server Holds the Record

Participation that depends on a vendor, a ministry, or a single data center is participation on someone else's terms.

Municipalities are laboratories for democratic innovation, and a laboratory should own its own instruments. A council that hosts its own instance holds its own records, sets its own pace, and owes nothing to a supplier. There is no licence fee and no vendor. The code is open source under the Apache 2.0 licence, and the constitutional rules it carries are in the public domain.

The same is true for a community that has no institution to rely on: a diaspora, a community in exile, a neighborhood after a disaster, or a youth council with a spare laptop. The engine was written so that the smallest machine can run the whole system. A slower computer takes longer. It does not get a lesser version.

From a Raspberry Pi to a Cloud Server

Every heavy task is cut into small, resumable pieces that size themselves to the machine. The same code runs on a single-board computer and on a large server. An interruption costs one piece of work, not the whole job.

Full Custody of Your Data

The jurisdiction owns its instance and its data. Updates arrive by running the same start command again, and they never touch your settings or your records.

Communication Built In

Each instance hosts its own chat and voice services, so the public square and the meeting rooms depend on no outside platform and have no central owner.

Ready for Serious Hosting

A high-availability configuration with database failover is included for a host that needs it, along with a guide for putting a node on the public internet at your own domain.

Getting Started

Six Steps From an Empty Machine to a Live World

Plan on about twenty gigabytes of free disk, and leave the computer on for the first run.
1Install Docker
The only prerequisite. Everything else runs inside it, so there is no database or programming language to install.
2Paste One Command
One line in a terminal on Windows, macOS, Linux, or a Raspberry Pi. It downloads the engine, starts it, and opens the setup page.
3Found a World or Join One
Start a new world, or join an existing one as a mirror by entering the host address and being approved from there.
4Choose Your Place
Pick the jurisdiction this world is for: a neighborhood, a city, a country, or the whole planet.
5Load the Map Data
Import real boundaries and population for one country or for all of them. The wizard shows progress the whole way.
6Seat the Institutions
District maps are drawn, the civic institutions are created, and you are signed in as the founder of a live world.

The setup wizard asks its questions in a browser and carries the founder the rest of the way. The constitutional defaults are presented as a starting reference, not as locks, and the founder may change them within the limits the constitution itself allows. The map data step can scope the import to a single country for a fast first world, or download the datasets country by country from inside the app.

Federation

Many Instances, One World, No Center

Instances connect as peers. Each jurisdiction has one authoritative home, and everyone else keeps a synchronized copy.

Join as a Mirror in One Step

Any computer can join an existing world as a mirror. It receives the public record and keeps it in step. A mirror is authoritative for nothing, so adding one can only add resilience.

Full Faith and Credit

Public records carry across instances. A city, a region, and a country can each run their own authoritative instance and still form one nested system, which is how multi-level government works in practice.

Nothing Private Federates

Federation carries a signed copy of the public audit record and public records only. It never carries ballots, raw locations, or credentials.

Restoration When a Government Fails

If a government is captured or destroyed, the constitution provides an ordered path to restore it: first its member jurisdictions, then the jurisdiction above it, then the residents themselves. Because the record is mirrored, there is something left to restore from.

The Survival Mesh

Instances can reach each other over more than one kind of network, so the federation survives when one path fails.
The Open Internet
The ordinary path, with automatic certificates for a public address.
A Private Network
An encrypted private network between trusted machines, with no public exposure at all.
Tor
An anonymizing route for places where reaching a civic server is itself a risk.
Yggdrasil
An end-to-end encrypted mesh that can run over local links when the wider network is down.

Between governments, in the live demo.

In the Engine

Between Governments

When two self-governing places share an edge, or disagree about where it sits, the constitution gives a peaceful way through. The people who live inside the moving boundary deliberate and vote, the change passes by a two-thirds supermajority of the affected population, and the map updates. Rights re-attach automatically on the new side of the line, and nobody has to register again.

Jurisdictions can also merge into a union or remove a middle layer, each as a defined constitutional process with its own thresholds.

In the Engine

Operators Keep the Box On. They Hold No Office.

The operator area is where a host manages peers, transports, and the sync ledger. It is walled off from the civic game. A signed-in operator sees it, and an ordinary resident does not.

The page says so itself. Joining, syncing, and naming peers are capabilities. They buy no vote, no seat, and no say in any constitutional act.

The operator area in the live demo, seen by a resident who is not an operator.

The Operator Is Not the Government

Running the server gives a person control of the machine, not of the constitution. The rules of the polity change only through valid legislative acts recorded on the public chain. The settings an operator can reach govern the box: addresses, certificates, and capacity. The software is pre-alpha and has not been security-audited, so a node today is for evaluation and pilots, not for binding decisions.

See It Running

Open the Live Demo and the Documentation

The demo is a pre-alpha instance for evaluation. Some areas ask you to sign in, and some open as the demo world finishes building. Nothing entered there is a real civic act.
Keep Exploring

Related Reading

The Constitutional Engine

One gate for every civic act, a tamper-evident public record, and rules no administrator can bend.

How the Maps Are Drawn

Open boundary and population data, combined into first-draft districts for the whole planet.

The Atlas

The public dashboard of the whole world. A gauge, never a lever.

Jurisdictions in the Template

Nested jurisdictions, unions, and the powers they share.

Constitutional Order in the Template

How a constitutional order is protected and restored.

Local Coalition Support

How the Coalition supports local groups.

Get Involved

Host a Pilot. Break It. Tell Us How.

A pilot instance in a real municipality, university, or civil society network is the most valuable thing this project can receive. We are also looking for an independent security audit and for people who run infrastructure in difficult conditions.