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 |
An Android thin client, which joins an existing node from your phone, is built and working. It is not in the tester downloads yet.
On Windows and Linux the download is two files, the program and a content package
(urchin.pck); keep them in the same folder or the app will not start. macOS is a single
zipped app.
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). The node starts those processes itself whenever it comes up, using the copies that shipped with the app. There is nothing for you to install, start, or keep running by hand. Two things worth knowing:
- Isolated by design. Kunuleco runs its own IPFS, Tor, and Veilid on non-default ports, so an existing install of any of them keeps running untouched.
- 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 every release against a signed manifest before it acts on it. The app you downloaded carries the signing key, so it is the trust anchor: a manifest that does not verify is refused outright, and no update is applied from one.
- 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.