rackd

README

Rackd

Open-source IP Address Management (IPAM) and Device Inventory System

Rackd is a lightweight, self-contained infrastructure management tool for tracking devices, networks, IP addresses, and datacenter resources. Built with Go and SQLite, it requires no external dependencies and runs as a single binary.

⚠️ Warning: This project is under active development and should not be used in production environments.

Features

Core Capabilities

• Device Inventory: Track servers, switches, routers, and other network devices
• IP Address Management (IPAM): Manage networks, subnets, VLANs, and IP pools
• Network Discovery: Automated network scanning and device discovery
• Datacenter Management: Organize devices by physical location
• Device Relationships: Track dependencies and connections between devices
• Full-Text Search: Fast FTS5-powered search across devices, networks, and datacenters

DNS & Network Services

• DNS Management: Zone management with external provider sync (Cloudflare, Route53, PowerDNS)
• NAT Tracking: Manage NAT pools and mappings
• Circuit Tracking: Document network circuits and providers

Security & Access Control

• RBAC: Role-Based Access Control with fine-grained permissions
• Audit Trail: Complete change history for compliance and troubleshooting
• Webhooks: Event-driven integrations with external systems

Extensibility

• Custom Fields: User-defined fields on devices and networks
• IP Reservations: Reserve IPs for future use with owner tracking
• Import/Export: JSON/CSV bulk data operations
• MCP Server: Model Context Protocol integration for AI/automation tools

Interfaces

• Web UI: Modern, responsive interface built with Alpine.js and TailwindCSS
• CLI Tool: Full-featured command-line interface for automation
• REST API: Complete HTTP API for integrations
• Monitoring & Metrics: Prometheus-compatible metrics and health checks

Quick Start

# Download the latest release
curl -LO https://github.com/martinsuchenak/rackd/releases/latest/download/rackd-linux-amd64

# Make it executable
chmod +x rackd-linux-amd64

# Start the server
./rackd-linux-amd64 server

# Access the web UI at http://localhost:8080

Documentation

Comprehensive documentation is available in the docs/ directory:

Getting Started

• Installation - Installation methods and requirements
• Quick Start Guide - Get up and running in 5 minutes
• Configuration - Environment variables and settings
• Configuration Reference - Complete configuration options
• Authentication - API key management and security
• User Authentication - User login and session management

Core Features

• CLI Reference - Command-line interface documentation
• API Reference - REST API endpoints and examples
• MCP Server - Model Context Protocol integration
• Web UI - Web interface guide

Modules

• Device Management - Device inventory and tracking
• Network Management - IPAM, subnets, and IP pools
• Datacenter Management - Physical location tracking
• Discovery - Network scanning and auto-discovery
• Relationships - Device dependencies and connections
• DNS Management - DNS zones, providers, and sync
• Webhooks - Event notifications and integrations
• Custom Fields - User-defined fields
• Circuits - Network circuit tracking
• NAT - NAT pool management
• Reservations - IP reservation tracking
• Conflicts - IP conflict detection and resolution

Security & Compliance

• RBAC - Role-Based Access Control
• Security - Security best practices
• Audit Trail - Change history and compliance logging
• Rate Limiting - API rate limiting configuration

Operations

• Deployment - Docker, Nomad, and production deployment
• Monitoring - Metrics, health checks, and observability
• Backup & Restore - Data backup strategies
• Import/Export - Bulk data operations
• Troubleshooting - Common issues and solutions

Development

• Architecture - System design and structure
• Development Guide - Building and contributing
• Database Schema - SQLite schema reference
• Testing - Testing strategy and guidelines

Technology Stack

• Backend: Go 1.25+ (CGO-free)
• Database: SQLite (embedded, no external dependencies)
• Frontend: TypeScript, Alpine.js, TailwindCSS v4
• Build: Make, Bun (frontend)
• CLI: paularlott/cli
• MCP: paularlott/mcp

Building from Source

# Clone the repository
git clone https://github.com/martinsuchenak/rackd.git
cd rackd

# Install dependencies
go mod download
cd webui && bun install && cd ..

# Build
make build

# Run
./build/rackd server

See Development Guide for detailed build instructions.

Support

• Documentation: docs/
• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Website: getrackd.dev

License

MIT License - see LICENSE file for details.