lanbugsde/mossboard-frontend repository overview

⁠mossboard-frontend

MOSSBoard Frontend — Vue 3 SPA served via nginx

MOSSBoard⁠ (Max's OpenSource Status Board) is a self-hosted, Docker-based status page for displaying the operational state of your services. This image serves the Vue 3 single-page application via nginx and acts as the single public-facing entry point for the entire stack — it proxies all API, docs, and OpenAPI traffic to the backend container.

⁠What's inside

• Vue 3 + Vite frontend compiled with Tailwind CSS and Lucide icons (JetBrains Mono, self-hosted)
• nginx reverse proxy: serves the SPA and forwards /api/, /docs, /openapi.json to the backend
• Public status page: overall status banner, collapsible service sections, 24-hour history bars, and scheduled maintenance notices
• Service detail view: 5-minute granularity history bar, 30-day uptime summary, status change log, and incident timeline
• Fullscreen monitor view: optimized for wall displays, live clock, pulsing indicators for degraded services
• Admin interface: manage sections, services, incidents, maintenance windows, monitors, API tokens, and users
• Dark / light theme toggle, persisted in localStorage

⁠Stack

⁠Exposed port

All API, docs, and OpenAPI requests are proxied internally to mossboard-backend.

⁠Available routes

⁠Required companion services

• mossboard-backend

⁠Quick start

git clone https://github.com/lanbugs/mossboard.git
cd mossboard
cp .env.example .env   # set SECRET_KEY and ADMIN_PASSWORD
docker compose -f docker-compose.hub.yml up -d

Open http://localhost:3444/ for the public status page and http://localhost:3444/admin for the admin interface.

See the MOSSBoard GitHub repository⁠ for the full docker-compose.hub.yml and documentation.

⁠License

GNU General Public License v3.0 — © 2026 Maximilian Thoma