tanmoysrt/labcaptain_base repository overview

labcaptain_base docker image is a base image to build your own lab environment on top of.

⁠Why should you use this image?

This image has many things pre-configured to make it easy to get started with a lab environment.

• Built on top of ubuntu 22.04
• Non-root user labuser configured
• Xfce4 with TigerVNC and noVNC support
• Web based code editor (VSCode like code-server)
• Web based terminal (ttyd)
• Integrated ingress handling with HAProxy
• Port proxy to handle port-based routing

⁠How to use this image?

docker run -it --rm -p 8080:80 tanmoysrt/labcaptain_base:1

Or, In your docker image, you can use this image as a base image

FROM tanmoysrt/labcaptain_base:1

⁠Where to put your lab files?

You can put your lab files in the following folders:

• /home/labuser/Desktop/lab

⁠How to access lab software?

• Access web terminal at http://terminal:8080⁠
• Access code editor at http://editor:8080⁠
• Access VNC at http://vnc:8080⁠
• Access port-based routing to any service inside the container by http://port-⁠<port_no>:8080

⁠Configuration via environment variables

⁠Restrictions

• In the lab image, do not run any service on these ports - 80, 8001, 8002, 8003, 8004

⁠License

MIT License

⁠Credits

Special thanks to this project - https://github.com/ConSol/docker-headless-vnc-container⁠ (Apache License 2.0). It made it possible to have proper configuration for Xfce4 + noVNC setup.

⁠Author

Tanmoy Sarkar @tanmoysrt⁠ Contact at [email protected]⁠

⁠Source Code

https://github.com/tanmoysrt/labcaptain/tree/main/base_image⁠