Skip to content

README.md

Latest commit

 

History

History
57 lines (41 loc) · 1.66 KB

README.md

File metadata and controls

57 lines (41 loc) · 1.66 KB

Tilework

Quality Gate Status

About

Tilework is a fully integrated reverse proxying and load balancing platform, using haproxy under the hood. It is designed with the main objective of being simple and fast to configure rather than being in the way.

Features

  • Deployment of HTTP/TCP load balancers with multiple backends
  • HTTP rules based routing, including hostname, URL path, query string
  • Certificate issuing via popular services, lifecycle management, auto-renewal
  • Realtime and historical service statistics
  • Docker based service deployment - no disruption of the host environment

Install

  1. Install docker engine or docker desktop. Be sure that docker compose is also installed.

  2. Create a docker-compose.yml file as follows:

services:
  tileworkui:
    image: tilework/tilework:latest
    ports:
      - 5180:5180
    environment:
      - ASPNETCORE_ENVIRONMENT=Docker
    volumes:
      - tilework_data:/var/lib/tilework
      - /var/run/docker.sock:/var/run/docker.sock

volumes:
  tilework_data:
    external: false
  1. Start the service up
# If using the docker-compose command
docker-compose up -d

# If using docker-compose-plugin
docker compose up -d
  1. Create an initial user
docker compose exec -it tileworkui dotnet tilework.ui.dll CreateUser

Follow the interactive prompts to set the username, email, and password.

  1. Navigate your browser to http://<host>:5180