shipherd
A sleek Docker container that provides a web-based GUI for running and managing your code on a home server. No more manual script execution.
Why Choose Shipherd?
Transform your home server into a powerful project management hub with intuitive controls and robust monitoring.
Project Management
Organize and run multiple projects from a single dashboard. Support for Python, Node.js, and more with automatic dependency management.
Smart Auto-Restart
Configurable crash recovery, file change detection, and scheduled restarts. Keep your projects running smoothly without manual intervention.
Persistent Data Protection
Your data stays safe in protected directories that survive code updates and Git syncs. Never lose important project data again.
Real-time Monitoring
Live logs, searchable history, and webhook alerts. Stay informed about your projects' health with comprehensive monitoring tools.
Git Integration
Sync your projects directly from Git repositories. Automatic updates while preserving your persistent data and configurations.
Secure & Isolated
Admin authentication, project isolation, and future-ready user role support. Built with security and scalability in mind.
Installation
Get Shipherd running on your platform in minutes. Choose your preferred deployment method below.
Docker Compose (Recommended)
Create a docker-compose.yml file:
services:
shipherd:
image: marvilco/shipherd:latest
container_name: shipherd
ports:
- "9744:9744"
volumes:
- ./data:/app/data:rw
environment:
- TZ=America/New_York
- LOG_FORMAT=pretty # or json
restart: unless-stopped
Then run:
docker-compose up -d
Docker Run
Run Shipherd with a single Docker command:
docker run -d \
--name shipherd \
-p 9744:9744 \
-v ./data:/app/data:rw \
-e TZ=America/New_York \
-e LOG_FORMAT=pretty \
--restart unless-stopped \
marvilco/shipherd:latest