louislam / demo-kuma

Demo Kuma

Create a demo site for your Docker based web application.

Live Demo (Uptime Kuma): https://demo.kuma.pet/start-demo

ExerciseDiary (2 mins demo) - Another selfhosted app which I found on Reddit: https://exercisediary-demo.kuma.pet/start-demo

Features

• Quickly create a demo for your project.
• Spin up a docker stack when requested, shut down the stack when time is up.
• A countdown timer at the bottom right corner.
• Custom demo duration.
• Portless demo instances design in v2, you just need one port for Demo Kuma.

How to use

1. Create a stack directory demo-kuma.
2. Download compose.yaml and compose-demo.yaml into the directory.
   • compose.yaml = Demo Kuma stack
     • You should go through all variables in the environment: section.
   • compose-demo.yaml = The stack that you want to provide a demo
     • By default, the main service should be main and the network name should be demo-kuma_default.
     • If your stack name is not demo-kuma, you should change the network name to {your-name}_default
3. docker compose up -d.
4. Go to http://localhost:3003/start-demo to test the demo.

How it works?

1. Demo Kuma takes control of your Docker
2. User requests a demo via a browser
3. Demo Kuma assign a session ID for this request and spin up the stack compose-demo.yaml
4. Once the demo stack is started, Demo Kuma will act as a reverse proxy to communicate between the browser and the demo stack.
5. The timer will be created at the same time. When time is up, Demo Kuma will shut down the stack.

More screenshots