Skip to content

Spacecraft-Software/Flux

Repository files navigation

Flux

DNS Selector & Network Configurator for Linux and BSD.

Flux detects the active DNS/NTP subsystem, applies encrypted DNS (DoT/DoH/DoQ/DNSCrypt), optionally configures NTP, and orchestrates VPN clients (Cloudflare WARP, AdGuard VPN CLI). Part of Project Spacecraft Software.

Quick Start

# Apply Cloudflare Family DNS over DoT
dns apply cloudflare family dot

# Same, machine-readable
dns apply cloudflare family dot --json

# Show current state
dns status --json

# List providers
dns list --providers --json

# Detect backend
dns detect --json

Supported Operating Systems

  • Linux: Arch, Debian/Ubuntu, Fedora, openSUSE, NixOS
  • BSD: FreeBSD, OpenBSD, NetBSD

Supported DNS Providers

Provider Plain DoT DoH DoQ DNSCrypt VPN
Google
Cloudflare WARP
AdGuard AG VPN
Quad9
OpenDNS

Build

cargo build --workspace --release

Test

cargo test --workspace

Project Posture

Personal / Hobby. Audience: maintainer's own use case. Pace: hobby pace, no service-level commitments. Warranty: none, provided AS IS. Liability: none, see NOTICE.md. License: GPL-3.0-or-later governs binding terms. Maintainer discretion applies to PR acceptance, scope, and roadmap.

Maintainer

--- Forged in Spacecraft Software ---

About

DNS selector and network configurator.

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages