Install¶
Get the app¶
Kunuleco is in closed alpha: the download page is available to alpha testers (your welcome note has the link and credentials). Builds exist for:
| Platform | Notes |
|---|---|
| Windows x64 | Full node + client |
| Linux x64 | Full node + client |
| macOS (Intel and Apple Silicon) | Full node + client, experimental |
| Android | Thin client: joins an existing node from your phone |
The desktop app is Urchin, the graphical client. Your node (the part that owns your spaces and talks to other nodes) is bundled with it and managed for you.
First launch¶
On first launch the app installs everything it needs: the Kunuleco core plus the transport daemons it uses to reach other nodes (IPFS, and optionally Tor and Veilid). Two things worth knowing:
- Isolated by design. Kunuleco runs its own instances of IPFS and Tor on its own ports. If you already run either of them, nothing collides.
- Nothing else to fetch. A fresh install works even offline; see the note on trust below.
When the install finishes you land on the welcome screen, ready to create your identity.
How you can trust the download¶
Releases are cryptographically verified:
- The app checks each release against a signed manifest before it applies anything. The app you downloaded is the trust anchor, and nothing installs or updates without a valid signature.
- A fresh install works even offline, because the app carries that signed manifest with it.
- SHA-256 checksums for the downloads are published alongside them, so you can verify what you fetched by hand if you want to.
Updating¶
From the Urchin client:
| Command | What it does |
|---|---|
/check-updates |
Check whether a newer release is available |
/update |
Download and apply it (verified against the signed manifest) |
/restart |
Restart the client after a client update |
Some alpha releases need a fresh install
Occasionally an alpha release changes something foundational and /update is not
enough; the release notes will say so explicitly when a wipe-and-reinstall is required.
Export a backup of your identity first (see
First run); spaces and identity are yours to
carry across.