Matey is a container ingress configurator for traditional web servers. It uses container system events to set up reverse proxies and load balancers for your containers. Instead of reinventing the web server, we leverage tried and tested software.
Currently, Matey supports Docker and IIS. We chose this combination as our starting point because there are working solutions for Linux, such as Traefik. There are no such solutions for Windows hosts.
With this guide, you will install Matey and configure it to work alongside IIS and Docker.
- Docker (Installation guide)
- IIS 7.0+ (Installation guide)
- ARR module for IIS (Installation guide)
Matey is published as a Microsoft Software Installer (.msi) which can be found on the "Releases" page. To install, download the .msi and run the installer on your server.
Once the installer is finished, you should see "Matey Configurator Service" in the "Services" list. The service is now running and waiting for container events!
With everything installed, you can now set up a container which IIS will forward to. Run the following command to try it:
docker start --label matey.enabled=true --label matey.frontend.rule=Host:hello-world.localhost getmatey/hello-world
This will start our example hello-world container and make it accessible through hello-world.localhost on your server.
There is also an equivalent docker-compose.yml, if you prefer.
Having run this, head to http://hello-world.localhost in a browser on your server. You should be greeted with a "Hello, world!"
Welcome aboard! You've now run your first container with Matey. If you're looking for more advanced functionality, please head to the configuration guide.
Thanks to Becca Alizzi for her beautiful work on the whale and sail boat logo and documentation illustrations.
All Matey logos and illustrations are licensed under the Creative Commons 3.0 Attributions license.