readme.md

About the Project

This is a basic reverse-proxy configuration designed to run on a RaspberryPi. It uses Traefik running on Docker using Docker-Compose.

HTTPS is enforced by using Let's Encrypt with the HTTP Challenge.

Getting Started

Prerequisites

• Install Docker https://docs.docker.com/engine/install

• Install Docker-Compose https://docs.docker.com/compose/install

• Install apache-utils to get htpasswd for generating passwords.

  • Debian/Ubuntu/Raspbian/...

    # sudo apt-get update && sudo apt-get install apache2-utils -y

  • Fedora > 21

    # sudo dnf install apache2-utils -y

  • Fedora < 22

    # sudo yum install apache2-utils -y

Installation

1. Clone this repo

   # sudo git clone https://github.com/klumbe/ReverseProxy

2. Generate password(s) for the Traefik dashboard:

   # htpasswd ./conf/auth/traefik_basic <username>

3. Change the email-address used by Let's Encrypt in conf/traefik.yaml to your own:

   email: mail.example.org
   

   This will probably be improved in a future commit.

4. Create the external docker network traefik-external through that Traefik can connect to the services:

   # sudo docker network create traefik-external

5. Start the container in detached mode:

   # sudo docker-compose up -d