Setup Dockge and Crafty on Truenas Scale

14th February 2025, 22:16:00

The following Guide shows how I like to setup Docker on Truenas Scale with Dockge as Docker WebUI and also shows how to install Crafty Controller with it. You can use the Dockge instance for every other Docker App as well.

Prepare the Dataset

  1. Click on Datasets, then select the storage pool, then click on Add Dataset
    Step 1

  2. Enter a name, for example docker, make sure that Generic is set as Dataset Preset, then click on Save
    Step 2

  3. Click on the freshly created docker dataset, then create two more sub-datasets stacks and data with the same options

Step 3 StacksStep 3 Data

Step 3 Final

Creating the Dockge container

  1. Click on Apps then on Discover Apps
    Step 1

  2. Click on Refresh Catalog, search for dockge and click on it
    Step 2

  1. Install the app

    • If this is your first app, click on Setup Pool To Install, then select the pool you want to use for your App storage, then click on Choose
      Step 3 a

    • If this is not your first app, then simply click on Install
      Step 3 b

  2. Take note of the WebUI Port or change it to whatever you like
    Step 4

  3. The Storage Configuration

    • For Dockge Stacks Storage select Host Path as Type, then select the stacks dataset as the Host Path
    • For Dockge Data Storage select Host Path as Type, then select the data dataset as the Host Path
      Step 5
  4. Click on Install
    Step 6

Setting up Dockge

  1. Click on Web UI
    Step 1

  2. Create the admin account with a new Username and a Password
    Step 2

  3. Click on Compose, enter crafty as Stack Name, then paste the compose file from docs.craftycontroller.com into the text area.
    Step 3

  4. Adjust the docker compose file

    • Set the timezone to your local timezone. See this article for TZ identifiers.
      Since I live in Europe, I changed the timezone to CET/CEST with the adjustment:

      FromTo
      - TZ=Etc/UTC- TZ=Europe/Vienna
    • Remove the docker folder in all volumes. Dockge already creates a crafty folder for us, therefore we can simplify all volumes:

      FromTo
      - ./docker/backups:/crafty/backups- ./backups:/crafty/backups
      - ./docker/logs:/crafty/logs- ./logs:/crafty/logs
      - ./docker/servers:/crafty/servers- ./servers:/crafty/servers
      - ./docker/config:/crafty/app/config- ./config:/crafty/app/config
      - ./docker/import:/crafty/import- ./import:/crafty/import
  5. Click on Deploy
    Step 5

  6. Once crafty finished installing, you should be able to open https://ipofyourserver:8443. If you don’t know the ip address, look at the url of the dockge browser tab.

Logging in to Crafty

  1. Once you have crafty open, you should be greeted with a security warning, click on Advanced... and Accept the Risk and Continue
    Step 1

  2. Go back to Dockge, click on Bash
    Step 2

  3. Terminal fun

    • Change into the config directory of crafty: cd app/config

    • Print the contents of default-creds.txt: cat default-creds.txt

    • Copy the password (without quotes). On windows select it then press right click -> copy to copy it to clipboard. For example 25EMWLnOEBv5r0VzvpprihIky8l&otAMrkS#qw^Z&LOL6ym^w05aLB#Lr*2yubDT

    Step 3

  4. Go back to the Crafty tab, then enter admin as Username and enter the password we copied, then click on Log in
    Step 4

  5. Success!