A simple, local-first system for managing nodes and infrastructure.

Built for clarity, security, and full control — without cloud dependencies.

No cloud. No tracking. No noise.

---

🚀 What is FoxRegistry?

FoxRegistry is a lightweight infrastructure registry where you keep track of nodes, services, and systems — stored locally and encrypted at rest.

Designed for:

• homelabs
• small infrastructures
• personal system tracking
• privacy-first environments

---

⚡ Quick Start (Docker)

cp docker-compose.example.yml docker-compose.yml
# set your password
docker compose up -d --build

Then open:

http://localhost:8095

---

🔐 Authentication & Startup

• First run: create your admin user
• Every startup requires your vault password
• No password = no access to data

---

🔑 Security Model

• Master key encrypted with PBKDF2
• Data always encrypted at rest
• Separate backup encryption key
• Optional recovery key (CLI only)

---

💾 Backups

• Encrypted .tar.enc backups
• Trigger via UI or API
• Auto-backup scheduler
• Separate backup key

---

🛠 Recovery

• Reset password via recovery key (CLI)
• Without recovery key → data is unrecoverable

---

🧩 Features

• Encrypted local data storage
• Simple node management UI
• Secure login & sessions
• Backup + restore system
• Docker-ready deployment

---

🐳 Docker Notes

Config stored in:

~/.config/foxregistry/

---

Built with ❤️ for Lanx by NodeFox 🦊
Maintained by Eddie Nielsen

Learn. Adopt. Survive. Share.