chore(server): checkpoint deployed services and unfinished forums

User requested a checkpoint and stopped all agents. Deployed artifacts remain the last verified releases; unfinished settings/categories/forums are preserved as WIP. See TODO/roadmap for verification and remaining release/updater work.
This commit is contained in:
Loki 2026-11-01 15:31:20 +01:00
parent d6d406bbf5
commit c18ccadf99
Signed by: boba
GPG key ID: 253067914055423B
96 changed files with 8665 additions and 276 deletions

View file

@ -48,25 +48,44 @@ sqlite_path = "./dev/data/vnox.db"
## First run
Run from `VNOX-Server/`:
```sh
mkdir -p dev/data
cargo run -p vnox-gateway -- --config dev/config.toml
cargo run -p vnox-voice-node -- --config dev/config.toml
cargo run -p vnox-client
cargo run -p vnox-serverd -- --config dev/config.toml
```
`vnox-serverd` runs the TCP gateway and UDP relay together and passes voice
credentials through their in-process bridge. Separate gateway and voice-node
processes do not yet exchange credentials; the standalone relay rejects voice
traffic.
In another terminal, run from `VNOX-Client/`:
```sh
cargo run --bin vnox-client
```
Connect to `127.0.0.1:7600`. The gateway generates a self-signed TLS certificate
for local development and prints its SPKI SHA-256 fingerprint. Compare it with
the client's first-use trust prompt before accepting.
On first gateway start, `dev/data/server_identity.json` is created automatically.
Back it up if you care about a stable server identity across reinstalls.
## E2E voice test
With gateway and voice-node running:
With `vnox-serverd` running, execute from `VNOX-Client/` using the fingerprint
printed by the gateway (replace `HEX`):
```sh
cargo run -p vnox-client --bin vnox-e2e-voice
cargo run --bin vnox-e2e-voice -- --fingerprint HEX
```
For a disposable loopback test, `--trust-first-use` can replace `--fingerprint HEX`.
The headless test keeps certificate trust in memory only.
This headless test connects two TCP clients, joins the `voice` channel, sends UDP packets, and verifies the voice-node relays between them. Exit code 0 means pass.
## Logs
@ -74,7 +93,7 @@ This headless test connects two TCP clients, joins the `voice` channel, sends UD
Set log level via environment variable:
```sh
VNOX_LOG=debug cargo run -p vnox-gateway -- --config dev/config.toml
VNOX_LOG=debug cargo run -p vnox-serverd -- --config dev/config.toml
```
## Full reference

View file

@ -3,6 +3,10 @@ name = "dev-node"
address = "127.0.0.1"
[gateway]
# Central account UUIDs explicitly authorized for global channel management.
# Device public keys and nicknames are not accepted here.
admin_account_ids = []
bind = "127.0.0.1:7600"
max_connections = 100
session_timeout = 600
@ -12,13 +16,19 @@ admin_bind = "127.0.0.1:7601"
message_rate_per_sec = 5
# Burst size for the token bucket.
message_rate_burst = 10
# TLS 1.3 is always on (LNEx v3). With neither option below the gateway generates
# TLS 1.3 is always on (LNEx v4). With neither option below the gateway generates
# a self-signed certificate in <data_dir>/tls/ (key = server identity) and prints its
# SPKI SHA-256 fingerprint at startup. Clients pin it on first use.
# For a public CA certificate (for example Let's Encrypt) set both paths and restart on renewal:
# tls_cert_path = "/etc/letsencrypt/live/chat.example.org/fullchain.pem"
# tls_key_path = "/etc/letsencrypt/live/chat.example.org/privkey.pem"
# Required for account admission: copy the issuer UUID/public key from your trusted
# Central operator. No configured issuer means every client admission is rejected.
# [gateway.central_account]
# issuer = "<Central issuer UUID>"
# public_key = "<64-character Ed25519 public key hex>"
[voice]
bind = "127.0.0.1:7700"