This is an open-source user interface designed to be your internally hosted homepage for your homelab/server.

Lab Dash features a customizable grid layout where you can add various widgets:

• Shortcuts to your tools/services
• System information
• Service health checks
• Custom widgets and more

You can easily customize your dashboard by:

• Dragging and reordering
• Changing the background image
• Adding custom search providers
• Custom title and tab name

You have complete control over your data and dashboard configuration.

• All data is stored & used on your own device
• Sensitive data is encrypted locally using AES-256-CBC
• Only administrator accounts can make changes
• Configurations can be easily backed up and restored

This only requires docker to be installed. Install Docker. Run using docker compose

---
services:
  lab-dash:
      container_name: lab-dash
      image: ghcr.io/anthonygress/lab-dash:latest
      privileged: true
      network_mode: host # for monitoring network usage stats
      ports:
        - 2022:2022
      environment:
        - SECRET=YOUR_SECRET_KEY # any random string for used for encryption.
        # You can run `openssl rand -base64 32` to generate a key
      volumes:
        - /sys:/sys:ro
        - /docker/lab-dash/config:/config
        - /docker/lab-dash/uploads:/app/public/uploads
        - /var/run/docker.sock:/var/run/docker.sock
      restart: unless-stopped
      labels:
        - "com.centurylinklabs.watchtower.enable=true"

Lab Dash can aslo be accessed from any web browser via

• http://localhost:2022 on the device running the container
• 192.168.x.x:2022 on local network
• www.your-homepage.com using your custom domain name

Lab Dash can also be installed as an app on your computer/phone as a PWA (Progressive Web App):

• Using Google Chrome on Mac/Windows/Android/Linux
• Using Safari on iOS/iPad OS via the share menu > add to homscreen

Simply copy/download the docker-compose.yml or add it to an existing docker-compose file.

docker compose up -d

This docker container will restart automatically after reboots unless it was manually stopped. This is designed to be run on your hosting server.

1. Navigate to the directory that this docker compose file is in
2. Run: docker compose down

npm install
npm run dev

• Navigate to stacks
• Click on the lab-dash stack
• Click Editor tab at the top
• Click Update the stack
• Enable Re-pull image and redploy toggle
• Click Update

• cd /directory_of_compose_yaml
• docker compose down
• docker compose pull
• docker compose up -d

This code is provided for informational and educational purposes only. I am not associated with any of the services/applications mentioned in this project.