github Harry-kp/vortix v0.1.3
v0.1.3 — Config Management, VPN Lifecycle Hardening & Structured Logging

latest releases: v0.2.0, v0.1.8, v0.1.7...
one month ago

Highlights

Config Directory Overhaul

Vortix now auto-detects SUDO_USER so sudo vortix uses your real home directory instead of /root/. You can also override with --config-dir / -C or the VORTIX_CONFIG_DIR env var. Respects XDG_CONFIG_HOME on Linux.

Migration Prompt (Upgrading from 0.1.2)

If you previously ran vortix as root and have data under /root/.config/vortix/, a one-time prompt will offer to move your profiles, auth credentials, and settings to the new user-owned location. No data is lost — files are copied first, then removed from the old path.

config.toml Support

Timeouts, telemetry intervals, log settings, ping targets, OpenVPN verbosity, and more are now user-configurable via ~/.config/vortix/config.toml. All values have sensible defaults — the file is entirely optional. See the README for the full reference.

VPN Lifecycle Hardening

  • Cleaner connect/disconnect state machine with protocol-aware resource cleanup
  • No more lingering PID files or orphan processes on timeout, failure, or rapid connect/disconnect
  • Immediate telemetry refresh on VPN state changes
  • Stale disconnect results are ignored instead of corrupting state
  • Graceful cleanup on app exit (kill switch released, run files cleared)

Structured Logging

Log entries now follow a consistent [HH:MM:SS] LEVEL CATEGORY message format in both the TUI panel and log files. Log level, max entries, rotation size, and retention days are all configurable via config.toml.

Startup Dependency Check

Missing tools (curl, openvpn, wg-quick) are detected at launch with a warning toast and platform-specific install instructions — no more cryptic "os error 2" messages.


Bug Fixes

  • TUI freeze — Background scanner and network stats no longer block the main thread when network is down
  • UTF-8 panic — Log truncation now respects multi-byte character boundaries
  • Linux CI — macOS-only symbols gated behind cfg(target_os = "macos")

Documentation

  • Arch Linux installation instructions
  • Directory structure and configuration guide
  • All configurable settings documented in README
  • curl added as an explicit dependency for Linux

Install

crates.io:

cargo install vortix

Binary (shell installer):

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/Harry-kp/vortix/releases/download/v0.1.3/vortix-installer.sh | sh

Arch Linux:

pacman -S vortix

Download

File Platform Checksum
vortix-aarch64-apple-darwin.tar.xz Apple Silicon macOS checksum
vortix-x86_64-apple-darwin.tar.xz Intel macOS checksum
vortix-aarch64-unknown-linux-gnu.tar.xz ARM64 Linux checksum
vortix-x86_64-unknown-linux-gnu.tar.xz x64 Linux checksum
vortix-aarch64-unknown-linux-musl.tar.xz ARM64 MUSL Linux checksum
vortix-x86_64-unknown-linux-musl.tar.xz x64 MUSL Linux checksum

Don't miss a new vortix release

NewReleases is sending notifications on new releases.