https://github.com/AnthonyGress/lab-dash
An open-source user interface designed to manage your server/homelab applications and services.
https://github.com/AnthonyGress/lab-dash
application-dashboard dashboard docker docker-compose homelab homepage jellyfin metrics nodejs plex radarr react rest-api self-hosted server sonarr typescript
Last synced: 1 day ago
JSON representation
An open-source user interface designed to manage your server/homelab applications and services.
- Host: GitHub
- URL: https://github.com/AnthonyGress/lab-dash
- Owner: AnthonyGress
- License: gpl-3.0
- Created: 2025-02-14T20:59:51.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-05-01T00:25:01.000Z (4 days ago)
- Last Synced: 2025-05-01T01:28:47.222Z (4 days ago)
- Topics: application-dashboard, dashboard, docker, docker-compose, homelab, homepage, jellyfin, metrics, nodejs, plex, radarr, react, rest-api, self-hosted, server, sonarr, typescript
- Language: TypeScript
- Homepage:
- Size: 9.86 MB
- Stars: 126
- Watchers: 5
- Forks: 4
- Open Issues: 23
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# Lab Dash
This is an open-source user interface designed to be your internally/externally hosted homepage for your homelab/server.
# Features
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
### Customization
You can easily customize your dashboard by:
- Dragging and reordering
- Changing the background image
- Adding custom search providers
- Custom title and tab name
### Privacy & Data Control
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](https://docs.anchormydata.com/docs/what-is-aes-256-cbc)
- Only administrator accounts can make changes
- Configurations can be easily backed up and restored
# Installation
This only requires docker to be installed. [Install Docker](https://docs.docker.com/engine/install/). Run using `docker compose`
```yaml
---
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"
```
# Usage
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
> [!IMPORTANT]
> You should assign a static IP address for you server so any LAN/WAN device can access the Lab Dash instance.
Simply copy/download the [docker-compose.yml](docker-compose.yml) or add it to an existing docker-compose file.
## Running Docker compose file
```bash
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.
## Stopping this docker container
1. Navigate to the directory that this docker compose file is in
2. Run: `docker compose down`
# Local Development
```
npm install
npm run dev
```
# Updating
### Portainer
- 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
### Docker CLI:
- `cd /directory_of_compose_yaml`
- `docker compose down`
- `docker compose pull`
- `docker compose up -d`
# Disclaimer
This code is provided for informational and educational purposes only. I am not associated with any of the services/applications mentioned in this project.