Archive/admin-panel

Habland Admin Panel

Next.js 16 control surface for managing the multi-emulator stack (Arcturus, Havana, Kepler, Roseau) from one UI. Ships with container controls, live stats, config editing, and log viewing.

Prerequisites

• Node.js 20+
• Docker running locally (the app talks to the Docker socket when containerized)
• .env with admin credentials (see below)

Quickstart (local dev)

cd admin-panel
npm install
cp ../.env.example .env        # reuse root values; add admin credentials
npm run dev                     # http://localhost:3000

Production (Docker Compose)

The root docker-compose.yml builds this app as admin-panel on port 3000 and mounts /var/run/docker.sock so it can manage other containers. Update .env before docker compose up -d.

Key Features

• Container manager: start/stop/restart per service or per emulator group
• Live stats cards: online counts per emulator (polls /api/stats)
• Config editor: edit mounted emulator configs directly from the UI
• Log viewer: tail per-container logs with filtering
• Global search and quick actions (keyboard shortcuts supported)

Scripts

• npm run dev – start Next dev server
• npm run build – production build
• npm start – serve built app
• npm run lint – lint the codebase

Environment Variables

Define in .env (or the root .env that gets baked into Docker):

• ADMIN_USER / ADMIN_PASSWORD – required. Basic credential pair used by the credentials auth provider in src/auth.ts.

Useful Paths

• UI entry: src/app/page.tsx
• Dashboard: src/components/Dashboard.tsx
• API routes: src/app/api/*
• Auth config: src/auth.ts, src/auth.config.ts

Notes

• The dashboard polls /api/containers and /api/stats every few seconds; ensure the emulator containers and the unified DB are up for meaningful data.
• When running via Docker, the app needs access to the Docker socket for container control.