TangoMan Traefik

TangoMan Traefik: Streamline Your Traefik Setup with Docker.

📝 Notes

Local traefik dashboard will be available here: http://traefik.localhost/dashboard

Local Traefik api endpoint will be available here: http://traefik.localhost/api/rawdata

🎯 Features

TangoMan Traefik provides the following features:

• Docker compose.yaml configuration for dev and prod environments
• Makefile
• entrypoint.sh script

🚀 Installation

1. Enter following command in your terminal

# build and run with `dev` settings
make up

# build and run with `prod` configuration
make up env=prod

2. Choose username

Choose dashboard username (eg: root):

3. Choose password

Choose dashboard password (eg: toor):

4. Enter let's encrypt email

Enter let's encrypt email (eg: [email protected]):

5. Enter traefik network name

Enter traefik network name : [traefik]

💻 Dependencies

TangoMan Traefik requires the following dependencies:

• apache2-utils : sudo apt-get install --assume-yes apache2-utils
• docker : http://docs.docker.com/engine/install
• docker-compose : https://docs.docker.com/compose/install/linux
• yq : https://mikefarah.gitbook.io/yq/v3.x
• Make (optional) : sudo apt-get install --assume-yes make
• mkcert (dev) : https://github.com/FiloSottile/mkcert
• yamllint (dev) : https://yamllint.readthedocs.io

🔥 Usage

🤖 Make

Run make to print help

make [command]

🤖 entrypoint

See entrypoint.sh documentation

🐞 Troubleshoot

If you encounter issues, try these steps:

• Run make logs to check container logs for errors.
• For permission problems, use sudo or adjust your user permissions.

If you see this error:

2025-07-22T15:51:07Z ERR Error while starting server error="accept tcp [::]:443: use of closed network connection" entryPointName=websecure

🚫 Traefik failed to start on port 443 (HTTPS) for the websecure entry point.

Possible Causes:

• Port 443 is already in use: Another process may be using port 443. Check with sudo lsof -i :443 or netstat -tulpn | grep :443.
• Insufficient permissions: Listening on ports below 1024 (like 443) often requires root privileges. Try running sudo make start.

🤝 Contributing

Thank you for your interest in contributing to TangoMan Traefik.

Please review the code of conduct and contribution guidelines before starting to work on any features.

If you want to open an issue, please check first if it was not reported already before creating a new one.

📜 License

Copyrights (c) 2025 "Matthias Morin" <[email protected]>

Distributed under the MIT license.

If you like TangoMan Traefik please star, follow or tweet:

... And check my other cool projects.

🙏 Acknowledgements

• shellcheck: a static analysis tool for shell scripts (used for CI/CD)
• yamllint: a static analysis tool for yaml files (used for CI/CD)

Script created with shoe

👋 Let's Build Your Next Project Together !

Looking for an experienced Full-Stack Partner ?

Clean code. Clear communication.

From first sketch to final launch, I've got your back.