lferrarotti74/zerotier-rules-editor repository overview

⁠ZeroTier Rules Editor

A powerful, visual, and code-based editor for ZeroTier flow rules. This tool allows you to visually design, edit, and compile complex ZeroTier network rules without manual syntax errors.

⁠🚀 Key Features

• Visual Builder: Drag-and-drop interface to create rules using predefined Macros, Capabilities, Tags, and ZeroTier Addresses.
• Visualizer: See exactly what your rules do. The visualizer parses compiled rules back into a human-readable format, resolving constants like TCP SYN or IPv4.
• Code Editor: Full Monaco-based code editor with real-time compilation and syntax highlighting for advanced users.
• Safe Defaults: Comes pre-configured with a "safe" rule set that blocks non-IPv4/ARP/IPv6 traffic by default.
• Secure: Built on Alpine Linux with a non-root user and includes supply chain attestations (SBOM & Provenance).

⁠🐳 Supported Architectures

This image is built for multi-architecture support:

• linux/amd64 (Intel/AMD)
• linux/arm64 (Apple Silicon, Raspberry Pi 4+, AWS Graviton)

⁠🛠️ Quick Start

Run the container directly:

docker run -p 5000:5000 lferrarotti74/zerotier-rules-editor:latest

Open your browser to http://localhost:5000.

⁠📦 Docker Compose

You can easily add this to your existing stack:

services:
  rules-editor:
    image: lferrarotti74/zerotier-rules-editor:latest
    ports:
      - "5000:5000"
    restart: unless-stopped
    # Optional: Set a custom container name
    container_name: zt-rules-editor

⁠🔒 Security

• Non-Root: Runs as the node user (UID 1000) inside the container.
• Minimal Base: Based on node:24-alpine3.23 for a small attack surface.
• Healthcheck: Includes a built-in healthcheck endpoint at /health.