pared

Lightweight, secure control plane & real-time web dashboard in Crystal for Linux firewalld and NetworkManager host security.

Pared Logo

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 / firewalld IPv6_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 ss with 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/IPv6 AllowedIPs CIDR overlap detection.
  • Omnibar Keyboard-Driven UX: Keyboard navigation and mutation palette (Cmd+K or /) 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 via NOTIFY_SOCKET, and SQLite forensic audit logging.

Quick Start

Prerequisites

  • Fedora Linux or RHEL 9+ (systemd-based Linux distribution)
  • Crystal Compiler (v1.22+)
  • libsystemd development headers (systemd-devel)
  • firewalld and NetworkManager active daemons
  • D-Bus CLI utilities: gdbus (glib2) and dbus-monitor (dbus-tools)
  • Network and inspection runtime utilities: ss (iproute) and wg (wireguard-tools)
  • Optional: podman for 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:

To build the Sphinx HTML documentation locally:

sphinx-build -b html -W docs docs/_build/html

Repositories & Mirrors


Maintainer

Repository

pared

Owner
Statistic
  • 0
  • 0
  • 0
  • 0
  • 10
  • 2 days ago
  • August 7, 2026
License

GNU General Public License v3.0 or later

Links
Synced at

Thu, 19 Nov 2026 22:27:27 GMT

Languages