Skip to content

Traefik with all the stuffing. Onramp is a docker compose setup designed to allow users to get up to speed quickly and securely using Traefik, LetsEncrypt, Cloudflare Tunnels and other popular self hosted home lab services.

License

Notifications You must be signed in to change notification settings

traefikturkey/onramp

Repository files navigation

A docker-compose setup of common services with Traefik using Cloudflare dns-01 for letsencrypt certificates

Here is a complete list of available services and available games

This repo assumes that you are running a debian linux disto like Ubuntu!

You'll need a personal domain that's setup with Cloudflare and an scoped API token created like shown below, https://dash.cloudflare.com/profile/api-tokens

Cloudflare api token

Download OnRamp

After getting your Cloudflare API key you can run the following to do the basic setup automagically:

sudo apt install git make -y

sudo mkdir /apps
sudo chown -R $USER:$USER /apps
cd /apps
git clone https://github.com/traefikturkey/onramp.git onramp
cd onramp

make install

Edit the .env file to include Cloudflare credentials, your domain and the hostname of the current machine, save the file and exit.

make start-staging

Traefik will start and attempt to obtain a staging certificate, wait and then follow the on screen directions.

make down-staging

You are now ready to bring things up with the production certificates

make

Docker Services

Other docker services are included in the ./services-available directory. The configuration files include links to the web page for the services which has the available documentation.

Note : This also includes cautions and notices for some of the different services, so be sure to look at them.

To list them:

make list-services

They can be enabled by running the following commands:

make enable-service uptime-kuma
make restart

Note: this creates a symlink file in ./services-enabled to the service.yml file in ./services-available

and disabled with the following:

make disable-service uptime-kuma
make restart

To create a new service:

make create-service name-of-service

This will create a file in /services-available that is built using the service.template

Docker Overrides

Several docker overrides are included that allow extending the functionallity of existing services to add features like NFS mounted media directories and Intel Quicksync or Nvidia GPU support to the Plex and Jellyfin containers.

To list avaliable overrides:

make list-overrides

To enable an override:

make enable-override plex-nfs
make restart

To disable an override:

make disable-override plex-nfs
make restart

Note: this creates a symlink file in ./overrides-enabled to the override.yml file in ./overrides-available In addition users can place there own custom docker compose files into ./overrides-enabled and they will be included on normal start up as well as included in the backup file created when running make create-backup for more info on docker compose overrides see: https://docs.docker.com/compose/extends/#adding-and-overriding-configuration

Docker Game servers

Docker based Game servers are included in the ./services-available/games directory. The configuration files include links to the web page for the services which has the available documentation.

To list available games:

make list-games

To enable a game:

make enable-game factorio
make restart

To disable a game:

make disable-game factorio
make restart

External Services

External services can also be proxied through Traefik to list the available configurations:

make list-external

They can be enabled by running the following commands:

make enable-external proxmox
make restart

And disabled with the following:

make disable-external proxmox
make restart

Backing up Configuration

Create backup file

make create-backup

This will create a traefik-config-backup.tar.gz in the project directory

Copy backup file to another machine

scp ./backups/traefik-config-backup.tar.gz <user>@<other_host>:/apps/onramp/backups/

Restore backup file on the other machine

make restore-backup

Other make commands

Then you can run any of the following:

make          # does a docker compose up -d
make up       # does a docker compose up (this will show you the log output of the containers, but will not stay running if you hit ctrl-c or log out)
make down     # does a docker compose down
make restart  # does a docker compose down followed by an up -d
make logs     # does a docker compose logs -f
make update   # does a docker compose down, pull (to get the latest docker images) and up -d

# You can run multiple commands at once like this
make; make logs

Environment Variables

Many parts of the available services, overrides and games can be customized using variables set in your .env file If you open an available file and view it you will likely see many variables such as ${UNIFI_DOCKER_TAG:-latest-ubuntu}

UNIFI_DOCKER_TAG is the variable name latest-ubuntu is the default value

You can override this value by placing the following line in your .env file

UNIFI_DOCKER_TAG=latest-ubuntu-beta

This will enable pulling the latest-ubuntu-beta version of the unifi container instead of the default stable version

Please see https://docs.docker.com/compose/environment-variables/ for more information about environment variable in docker compose

About

Traefik with all the stuffing. Onramp is a docker compose setup designed to allow users to get up to speed quickly and securely using Traefik, LetsEncrypt, Cloudflare Tunnels and other popular self hosted home lab services.

Topics

Resources

License

Stars

Watchers

Forks