Setup Traefik, with TrueCharts, and configure ingress on TrueNAS Scale.
TrueNAS Scale setup completed.
TrueCharts catalog setup completed.
Certificate setup completed.
Logged in as administrative user.
Traefik will be the primary entrypoint for application traffic to the server. Prepare the server before installing Traefik depending on the load balancer employed on the system: integrated or MetalLB.
Integrated Load Balancer
If using the integrated load balancer, the Traefik application will likely share an IP address with the TrueNAS server. The TrueNAS dashboard is running on port 80 and 443 by default. Change the ports TrueNAS binds to so Traefik can utilize port 80 and 443, for a seamless HTTP and HTTPS experience.
System Settings -
General and open the settings for
Modify the web interface configuration as required. Choose new port numbers for the web interface.
|Web Interface HTTP Port||Choose an HTTP port.|
|Web Interface HTTPS Port||Choose an HTTPS port.|
Save the configuration and begin the confirmation process. The changes must be manually confirmed by accessing the server from the newly configured port.
Using the system IP address or configured domain, connect to TrueNAS using the configured port.
Once port 80 and 443 have been released from TrueNAS, continue to installing Traefik.
If setup and using MetalLB, Traefik should be configured to have a different IP address on the load balancer. Pick an IP address to use on the network and use it in the
LoadBalancer IP configuration for the web entrypoints in Traefik. With this configuration, both TrueNAS and Traefik can use ports 80 and 443 on their own IP address. For example,
192.168.1.44 will be used.
Navigate to the
Applications page in the TrueNAS Scale dashboard,
Apps on the main navigation.
Switch to the
Available Applications tab in the
Using the search tool, find the
traefik application. Verify Traefik is from the
TrueCharts catalog and is on the
Install to begin configuration and installation of the application. Configuration options not mentioned in this section can be left as default.
|Application Name||Name for the application.|
|Version Number||Version to use, latest by default.|
|Expert Mode||Enable if needed.|
|Log Level||How detailed logging should be.|
|General Log Format||Format for creating logs.|
|Access Logs||Enable to use access logging.|
Networking and Services
|Service Type||Traefik service dashboard, use |
|Service Type||TCP web entrypoint service for Traefik.|
|LoadBalancer IP||Only use with MetalLB, use a chosen IP address for the Traefik application to be exposed on. Leave blank if using integrated load balancer.|
|Web Entrypoint Port||HTTP port.|
|Web Secure Entrypoint Port||HTTPS port.|
Storage and Persistence
|App Config Storage||—||—|
|Type of Storage||Use PersistentVolume.|
|Read Only||Keep disabled, write permission required.|
|Size quotum of Storage||Maximum disk usage - can never be decreased, only increased.|
This ingress configuration only relates to the administrative dashboard of Traefik. Enable ingress to access the Traefik dashboard, but note that it will lack any login protection until an authentication provider is setup.
|Enable Ingress||Toggle ingress state.|
|HostName||Ingress host on the server domain.|
|Path Type||Prefix path.|
|Cert-Manager clusterIssuer||Cluster issuer for automatic certificates.|
|Traefik Middlewares||Leave empty until authentication provider is setup.|
Once an authentication provider has been setup, configure the middleware for the ingress.
Verify you have checked the TrueCharts documentation for Traefik and
Save. The application will begin installation and deploy. Navigate to the
Installed Applications tab to monitor the status.
When Traefik enters the
ACTIVE state, navigate to the dashboard in a browser window.