SaaShup

Self-service platform to deploy, upgrade and run Docker applications on hosts managed through NetBox.

SaaShup sits on top of NetBox with the netbox-docker-plugin or Passhup and an agent on each Docker host. Admins describe applications as templates. Users order instances of them, or enroll their own images. SaaShup creates the containers, wires the DNS and reverse proxy, keeps them up to date when new image versions are pushed, and notifies the people concerned.

Run

docker run -d -v saashup:/data \
 -p 1880:1880 --name saashup \
 ghcr.io/saashup/saashup

Set PUBLIC_IMAGE=true or PUBLIC_IMAGE=1 to allow any signed-in user to order or enroll images. When PUBLIC_IMAGE is unset, false, or 0, only emails listed in ADMIN_ALLOWED_EMAILS can order or enroll images.

Documentation

• Authentication
• Config profiles
• Public website APIs
• Registry webhooks
• Operations
• Testing
• Contributing

Development

npm ci
npm run dev

Test

npm test