pared
Pared
Pared is a secure, high-performance Linux host security control plane and real-time administrative web console written in Crystal. Built on Kemal and Blueprint server-rendered components with Datastar v1.0.5 SSE hypermedia streaming, self-hosted Pico CSS v2.1.1, SQLite3, and native libsystemd journal bindings, it unifies firewalld and NetworkManager orchestration into an air-gapped-ready administrative interface.
Pared features reverse-proxy mutual TLS (mTLS) passwordless authentication with SHA-256 fingerprint and CRL validation, Linux PAM/SSSD identity management, native C-bindings to libsystemd for live journal streaming, a 7-stage packet traversal simulator, an automated per-zone anti-lockout rollback guardian, and Podman/Netavark container network bypass auditing.
Key Control Plane Features
- Living Topology & Graph Engine: Directed acyclic graph (DAG) topology mapping physical interfaces, network bonds, bridges, WireGuard tunnels, Podman/Netavark container networks, firewall zones, and listening daemons.
- Trace-a-Packet Simulator: 7-stage deterministic packet evaluation pipeline simulating packet traversal across ingress interfaces, source overrides, rich rules, policies, NAT, IPv4
rp_filter/ firewalldIPv6_rpfilter, and socket targets without injecting live network traffic. - Anti-Lockout Guardian: Automated per-zone volatile staging snapshots with a 30-second rollback watchdog on disruptive zone target mutations (
DROP/REJECT), preventing operator lockout. - Visual Rich Rule Compiler & AST: Syntax validation, conflict detection (shadowed, contradictory, and duplicate rules), dual-stack IPv4/IPv6 CIDR containment, and plain-English rule translations.
- Host Socket & Daemon Correlator: Real-time correlation of open TCP/UDP sockets via
sswith local systemd service units, process IDs, and firewall exposure states. - Service Exposure Console: One actionable row per port/protocol merging listener and firewall state (ghost opening, shadow block, exposed, local only), with per-row remediation and live filtering.
- Netavark Container Bridge Inspector: Automatic discovery of Podman/Netavark container networks and zero-trust firewall bypass auditing on wildcard host port binds (
0.0.0.0,::). - WireGuard Orchestrator & Visual Hub: Live peer telemetry via
wg, handshake health classification, endpoint configuration, and dual-stack IPv4/IPv6AllowedIPsCIDR overlap detection. - Omnibar Keyboard-Driven UX: Keyboard navigation and mutation palette (
Cmd+Kor/) with server-side dispatch (/trace,/rollback <zone>,/wg peer <term>,/zone add). - Hardened Identity & Access Control: Linux PAM fallback with account expiration checks (
pam_acct_mgmt), SSSD InfoPipe D-Bus group resolution, X.509 client certificate mTLS with SHA-256 fingerprint and CRL checks, RBAC (SuperAdmin,NetAdmin,Auditor,Monitor), and CSRF protection. - Production Observability: Live host CPU/memory/bandwidth telemetry, real-time alert toasts, and systemd journal streaming over Datastar SSE (
/events/stream), native watchdog integration viaNOTIFY_SOCKET, and SQLite forensic audit logging.
Quick Start
Prerequisites
- Fedora Linux or RHEL 9+ (systemd-based Linux distribution)
- Crystal Compiler (
v1.22+) libsystemddevelopment headers (systemd-devel)firewalldandNetworkManageractive daemons- D-Bus CLI utilities:
gdbus(glib2) anddbus-monitor(dbus-tools) - Network and inspection runtime utilities:
ss(iproute) andwg(wireguard-tools) - Optional:
podmanfor Netavark container network and port-publish discovery - SQLite3 and OpenSSL
Installation & Local Setup
# 1. Clone repository & install shard dependencies
git clone https://gitlab.com/renich/pared.git
cd pared
shards install
# 2. Provision host system Polkit rules & seed default database
make setup
make seed
# 3. Compile and launch development server
make build
make run
The control plane web dashboard is available at http://localhost:3636. For offline UI work without touching host daemons, run PARED_TEST_MOCK=true ./bin/pared.
Default Demo Credentials
When seeded via make seed, default credentials are:
- Email:
admin@example.com - Password:
password
(Local system PAM user accounts with UID and GID >= 1000 can also authenticate directly).
Testing & Quality Assurance
Pared enforces strict quality gates across unit specs, headless Firefox/Geckodriver E2E browser specs, static analysis, security scanning, and documentation linting:
# Run unit & integration test suite
make spec
# Run headless Selenium E2E browser test suite (Firefox + geckodriver)
make test-browser
# Run static analysis and security vulnerability scan (Ameba + Flaw)
make lint
# Run reStructuredText documentation linters
find docs -name "*.rst" -exec crstlint {} +
crstlint CHANGELOG.rst CONTRIBUTING.rst
rstcheck -r docs/
Production Deployment & Systemd Service
Pared ships a single consolidated, production-hardened systemd unit at scripts/pared.service implementing kernel sandboxing, watchdog pinging, and least-privilege restrictions:
# Build production release binary
make release
# Install binary and systemd service
sudo install -m 755 bin/pared /usr/local/bin/pared
sudo install -m 644 scripts/pared.service /etc/systemd/system/pared.service
# Enable and start service
sudo systemctl daemon-reload
sudo systemctl enable --now pared.service
# Inspect service status and watchdog health
sudo systemctl status pared.service
Documentation & Reference Library
Architectural specifications, decision records, and audit reports are maintained in the docs/ directory:
- Technical Specifications
- Functional Specifications
- Project Roadmap
- Architecture Decision Records
- Echelon Protocol Security & Architecture Audits
To build the Sphinx HTML documentation locally:
sphinx-build -b html -W docs docs/_build/html
Repositories & Mirrors
Maintainer
- Rénich Bon Ćirić (@renich) — Creator & Lead Architect
- Released under the GNU General Public License v3.0 or later.
pared
- 0
- 0
- 0
- 0
- 10
- 2 days ago
- August 7, 2026
GNU General Public License v3.0 or later
Thu, 19 Nov 2026 22:27:27 GMT