Atom Dashboard

A modern, self-hosted start page and service dashboard with real-time monitoring, Docker integration, SSO authentication, and customizable widgets.

Features

Service Monitoring

Add your services and monitor their uptime in real-time with HTTP, TCP, and ICMP checks.

Docker Integration

View and manage Docker containers with live CPU/memory stats, logs, and terminal access.

SSO & OAuth

Authenticate with Google, GitHub, Microsoft, GitLab, Authentik, Keycloak, or any OIDC/SAML provider.

Customizable Themes

Light & dark mode, accent colors, background images, and full appearance editor.

Dashboard Widgets

System stats, weather, clock, calendar, bookmarks, notes, Docker summary, and more.

Multi-User

Role-based access with admin/member roles, tag-based service visibility, and user management.

Quick Start

docker-compose.yml
services:
  atom:
    image: ghcr.io/stackryze/atom-homepage:latest
    container_name: atom
    ports:
      - "3000:3000"
    volumes:
      - atom_data:/app/data
      - /var/run/docker.sock:/var/run/docker.sock:ro
    restart: unless-stopped

volumes:
  atom_data:

docker compose up -d

docker run -d \
  --name atom \
  -p 3000:3000 \
  -v atom_data:/app/data \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  --restart unless-stopped \
  ghcr.io/stackryze/atom-homepage:latest

git clone https://github.com/stackryze/atom-homepage.git
cd atom-homepage
npm install
npm run dev

Open http://localhost:3000 and create your admin account.

Architecture

Component	Technology
Frontend	Next.js 16, React 19, CSS Modules
Backend	Next.js API Routes (Server Components)
Database	SQLite via better-sqlite3
Auth	JWT, bcrypt, OIDC, SAML 2.0
Docker	Dockerode API client
Icons	Lucide React (800+), Simple Icons (2500+)

Next Steps

Installation Guide — Detailed setup instructions
Configuration — Customize your dashboard
Widgets — Add and configure widgets
Docker Integration — Container management
SSO Setup — External authentication
Community — Contribute widgets and features