Get a Quote   (408) 943-4100               TrueNAS Discord      VendOp_Icon_15x15px   Commercial Support Toggle between Light and Dark mode

Using Docker on TrueNAS SCALE

  2 minute read.

Last Modified 2022-08-31 16:30 EDT

SCALE includes the ability to run Docker containers using Kubernetes.

Docker is an open platform for developing, shipping, and running applications. Docker enables the separation of applications from infrastructure through OS-level virtualization to deliver software in containers.
Kubernetes is a portable, extensible, open-source container-orchestration system for automating computer application deployment, scaling, and management with declarative configuration and automation.

Always read through the Docker Hub page for the container you are considering installing so that you know all of the settings that need to be configured. To Set up a Docker Image, first determine if you wish the container to use its own dataset. Create a dataset for before hand if desired for host volume paths.

When you are ready to create a container, open the APPS page and click Launch Docker Image.


Fill in the Application Name and Image Repository for the docker container you’d like to set up. This example shows installation of the PiHole project.

Image And Policies

Click Next to move to the Container Settings section. In this example, PiHole needs the timezone and password set. Always refer to the dockerhub page for information on what the docker container requires.

SCALE Apps Container Settings

Clicking Next will open the Networking section. If the container needs special networking configuration it should be set here. Ports are configured in the next section. Once completed, click Next to move forward in the configuration process.

The PiHole Docker Hub page lists a set of ports that will need to be set. These values may need to be adjusted depending on the configuration of your system. TrueNAS SCALE requires all Node Ports to be above 9000.

SCALE App Port Forwarding List

Click Next when all the ports are configured.

The Host Path volume will be set to a dataset and directory paths which were created before attempting to deploy the container. PiHole uses volumes store your data between container upgrades. You will need to create these directories in a dataset on SCALE prior to installing this container.

SCALE App Host Path Volumes

Additional Volumes can be added to the container if needed. When all the settings have been entered, verify the Application and Container Name and click Submit.


TrueNAS SCALE will deploy the container.

SCALE App Deploying

When the deployment is completed the container will become active. If the container does not autostart, click the START button.

SCALE App Active

Clicking on the App card will reveal details.

SCALE App Status

With PiHole as our example we navigate to the IP of our TrueNAS system with the port and directory address :9080/admin/.