https://github.com/nooblk-98/lighthouse
A process for automating Docker container image updates ( alternative to watchtower with ui ).
https://github.com/nooblk-98/lighthouse
contributions-welcome docker lighthouse linux monitring open-source watchtower
Last synced: 5 months ago
JSON representation
A process for automating Docker container image updates ( alternative to watchtower with ui ).
- Host: GitHub
- URL: https://github.com/nooblk-98/lighthouse
- Owner: nooblk-98
- License: other
- Created: 2025-12-08T02:54:23.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-01-02T11:40:56.000Z (6 months ago)
- Last Synced: 2026-01-04T04:04:54.701Z (6 months ago)
- Topics: contributions-welcome, docker, lighthouse, linux, monitring, open-source, watchtower
- Language: JavaScript
- Homepage:
- Size: 1.51 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Lighthouse
A process for automating Docker container base image updates (alternative to watchtower).
---
## Features
- **Real-time Container Monitoring** - View live container stats and status
- **Manual & Auto Updates** - Check/update containers and skip exclusions
- **Email Notifications** - Optional SMTP alerts after updates
- **Multi-architecture Support** - `linux/amd64`, `linux/arm64`, `linux/arm/v7`
- **Modern Web UI** - React + Tailwind
- **RESTful API** - Python backend
- **Docker Compose Ready** - Quick setup with docker-compose
## Quick Start
### Prerequisites
- Docker & Docker Compose (v3.8+)
- Port 8066 (frontend) and 8000 (backend) available
### Installation
Run using pre-built images
```bash
docker-compose -f docker-compose.production.yml up -d
```
## Docker Compose (pre-built images)
Use `docker-compose.production.yml` to run the published images without building:
```yaml
services:
lighthouse:
image: lahiru98s/lighthouse:latest
container_name: lighthouse
ports:
- "8066:80"
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- ./settings.json:/app/settings.json
restart: always
networks:
- lighthouse-net
networks:
lighthouse-net:
driver: bridge
```
## Using Pre-built Images
Instead of building locally, pull the published images:
```bash
# Docker Hub
docker pull lahiru98s/lighthouse:latest
# GitHub Container Registry
docker pull ghcr.io/nooblk-98/lighthouse:latest
```
Run with compose:
```bash
docker-compose -f docker-compose.production.yml up -d
```
Run FrontEnd with remote Backend For developement
```bash
$env:VITE_API_PROXY_TARGET="http://80.225.221.245:8000"; npm run dev
```
Dev with compose:
```bash
docker compose -f docker-compose.dev.yml up --build
```
## UI Preview
## Development
### Run both services with Docker (recommended)
```bash
docker compose -f docker-compose.dev.yml up --build
```
### Run locally without Docker
**Backend**
```bash
cd server
pip install -r requirements.txt
python main.py
```
**Frontend**
```bash
cd client
npm install
npm run dev
```
For a non-local backend, set `VITE_API_PROXY_TARGET` before running Vite:
```bash
$env:VITE_API_PROXY_TARGET="http://your-backend:8000"
```
### Build images locally
```bash
docker-compose build
```
### View logs
```bash
docker-compose logs -f backend
docker-compose logs -f frontend
```
Contributions welcome
## TODO / Ideas
- Create login page for UI
- ~~Support custom registry credentials~~
- Improve scheduler UI: show detailed history and allow pause/resume.
- Add image cleanup after updates (configurable retention).