Replace the X25519/HKDF/ChaCha20 TCP layer with rustls TLS 1.3 (ALPN vnox-lnex/3). Auto-generate a self-signed certificate keyed by the server identity or load an operator certificate, publish the SPKI fingerprint, bind HELLO and AUTH signatures to the TLS exporter, reject plaintext, TLS 1.2 and LNEx v2 peers with an explicit error. BREAKING: protocol v3. Claude-Session: https://claude.ai/code/session_01GDjxLvBcnJqniFQGUGb1V4 |
||
|---|---|---|
| .. | ||
| config.toml | ||
| README.md | ||
Local development configuration
This directory holds the default config for running VNOX on your machine.
File: config.toml
[node]
name = "dev-node"
address = "127.0.0.1"
[gateway]
bind = "127.0.0.1:7600"
max_connections = 100
session_timeout = 600
[voice]
bind = "127.0.0.1:7700"
[storage]
data_dir = "./dev/data"
backend = "sqlite"
sqlite_path = "./dev/data/vnox.db"
Sections
[node]
name- shown to clients after connect (HELLO / session UI).address- public node address for future federation; local dev uses loopback.
[gateway]
bind- TCP listen address for client connections. Default dev port:7600.max_connections- connection cap (not enforced in all code paths yet).session_timeout- session lifetime in seconds; sent to clients asexpires_at.
[voice]
bind- UDP listen address for voice relay. Default dev port:7700.- Sent to clients as
voice_endpointwhen they join a channel.
[storage]
data_dir- gateway data directory; stores SQLite DB andserver_identity.json.sqlite_path- SQLite database file for chat history and user records.
First run
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
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:
cargo run -p vnox-client --bin vnox-e2e-voice
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
Set log level via environment variable:
VNOX_LOG=debug cargo run -p vnox-gateway -- --config dev/config.toml
Full reference
Production-oriented options: docs/03-server/configuration.md.