874dd33a6d
Bump package + crate + tauri identifier from 0.1.0 to 0.1.1 and rebuild the .deb. The 0.1.1 binary includes everything between fork-init and HEAD~0: - custom TCP/QUIC listen ports (default 9651/9652) - daemon-failure banner with shortcut to Settings - misc UX wording CHANGELOG split: 0.1.1 section closes the previously-Unreleased list; 0.1.0 untouched. release/mycellium-ui-private_0.1.0_amd64.deb removed and replaced by 0.1.1 with refreshed SHA256SUMS.
50 lines
1.9 KiB
Markdown
50 lines
1.9 KiB
Markdown
# Releases — Mycellium UI Private
|
||
|
||
Pre-built `.deb` of the private-network desktop client. Designed to coexist with the public-network variant `mycellium-ui` on the same machine (different identifier, different binary, different polkit action).
|
||
|
||
## Install
|
||
|
||
```bash
|
||
sudo apt install ./mycellium-ui-private_0.1.1_amd64.deb
|
||
```
|
||
|
||
`apt install` with a local path resolves runtime deps (`pkexec | policykit-1`, `libwebkit2gtk-4.1-0`, `libgtk-3-0`) automatically. Plain `dpkg -i` will fail if any of those are missing.
|
||
|
||
Tested on Debian 12 (bookworm) and Debian 13 (trixie).
|
||
|
||
## Verify
|
||
|
||
```bash
|
||
sha256sum -c SHA256SUMS
|
||
```
|
||
|
||
## What's inside
|
||
|
||
| Path | Purpose |
|
||
|---|---|
|
||
| `/usr/bin/mycellium-ui-private` | GUI launcher |
|
||
| `/usr/bin/mycelium-private` | Mycelium daemon (private-network track, v0.6.1, runs as root via pkexec) |
|
||
| `/usr/bin/mycellium-bootstrap-private` | Cleanup wrapper invoked by pkexec |
|
||
| `/usr/share/polkit-1/actions/tech.threefold.mycellium-ui-private.policy` | polkit action — auth cached per session (`auth_admin_keep`) |
|
||
| `/usr/share/applications/Mycellium UI Private.desktop` | Menu entry |
|
||
|
||
## First run
|
||
|
||
1. Open the app — sidebar pastille is grey (idle).
|
||
2. Go to **Settings → Private network** at the top.
|
||
3. Type a network name (UTF-8, 2–64 bytes — public, agreed with your peers).
|
||
4. Click **Generate 32-byte key**, then **Reveal hex** to copy and share with the other nodes through a secure channel.
|
||
5. Other nodes paste the hex into their **Import** field.
|
||
6. In Daemon configuration, add at least one bootstrap peer.
|
||
7. Click **Start daemon** in the sidebar — pkexec prompt the first time.
|
||
|
||
Without a network name AND a key file, the daemon refuses to start (the app surfaces a clear error).
|
||
|
||
## Uninstall
|
||
|
||
```bash
|
||
sudo apt remove mycellium-ui-private
|
||
```
|
||
|
||
The user data (identity key, network key) under `~/.local/share/tech.threefold.mycellium-ui-private/` is preserved across reinstall. Remove it manually if you want a fresh start.
|