Skip to content

itflow-org/itflow-docker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ITFlow

IT documentation, ticketing and accounting system for small MSPs.

View demo
Username: demo@demo | Password: demo

About · Docs · Forum · Report Bug · Request Feature

--

About this Image

This is the Docker image of ITFlow. This image was created by a community member, we don't "officially" support Docker. This image is not ready for production use.

Please see the wiki: https://docs.itflow.org/installation_docker

Usage

ITFlow Only (no Reverse Proxy)

  1. Copy docker-compose.yml to a directory.
  2. Within docker-compose.yml, adjust the environment: variables such as ITFLOW_NAME, ITFLOW_URL and ITFLOW_REPO (to your own MSPs fork).
  3. Copy the .env file to the same directory.

Enter your timezone, root domain and database password within this file. You can avoid this step entirely by adding the information to your docker-compose.yml file directly instead. Or being safe, by using docker secrets.

  1. Run docker compose up -d
  2. Go to your domain. You should be redirected to setup.php. Enter server information correlated to your set up .env and docker-compose.yml files.

Defaults: Username: itflow, Password: $ITFLOW_DB_PASS from .env, Database: itflow, Server: itflow-db

Complete Traefik Solution (Reverse Proxy)

  1. Copy the traefik docker-compose.yml to a directory.
  2. Within docker-compose.yml, adjust the environment: variables such as ITFLOW_NAME, ITFLOW_URL and ITFLOW_REPO (to your own MSPs fork).
  3. Copy the .env file to the same directory.

Enter your docker path (/srv/docker, ., etc), cloudflare info, timezone, root domain and database password within this file.

  1. Create your A records for your host.
  2. Run docker compose up -d
  3. Verify you are getting certificates through LetsEncrypt. You will have two public URLs, traefik.$ROOT_DOMAIN and $ITFLOW_URL.
  4. Go to your domain. You should be redirected to setup.php. Enter server information correlated to .env and docker-compose.yml

Defaults: Username: itflow, Password: $ITFLOW_DB_PASS from .env, Database: itflow, Server: itflow-db

Environment Variables

ENV TZ Etc/UTC

ENV ITFLOW_NAME ITFlow

ENV ITFLOW_REPO github.com/itflow-org/itflow

ENV ITFLOW_REPO_BRANCH master

ENV ITFLOW_URL demo.itflow.org

ENV ITFLOW_PORT 8080

# apache2 log levels: emerg, alert, crit, error, warn, notice, info, debug
ENV ITFLOW_LOG_LEVEL warn

ENV ITFLOW_DB_HOST itflow-db

ENV ITFLOW_DB_PASS null

Changing ITFLOW_REPO* Environment Variables

Please go about this by deleting your volume location ./itflow

In Beta

  • I strongly recommend putting your solution behind Authelia. If requested, I can supply more information on this topic.
  • This project is still in early beta and is considered a work in progress. Many changes are being performed and may cause breakage upon updates.
  • Currently, we strongly recommend against storing confidential information in ITFlow; ITFlow has not undergone a third-party security assessment.