Skip to main content

Install Immich on TrueNAS in 2025

Installing Immich​

Immich requires that we create three datasets (Immich, pgdata, data). A dataset is a file system that can be created within a storage pool, similar to a folder but with advanced features like individual permissions, encryption, and the ability to create snapshots.

Create Datasets on TrueNAS​

First thing you want to do is create a dataset for Immich, it can be left as generic. We will then create two more datasets within that Immich folder (dataset).

  1. Login to TrueNAS and select Datasets on the left.
  2. Select your data pool
  3. Select add dataset from the top right.
create dataset in TrueNAS

We need to create a main Data Set for Immich like Shown Below:

creating dataset called immich

We need to create another dataset WITHIN our Immich dataset like we just created. You will do this by selecting the Immich dataset FIRST, then selecting add a data set again on the top right.

For our first dataset, we will call it pgData you can keep the default preset Generic as permissions can be set during the installation of the Immich app (pgdata stands for postgre data).

create your pgdata set for immich

Create a second data set UNDER the Immich dataset called data that will be given the data set preset of apps.

data dataset

Install Immich app on TrueNAS​

  1. To install Immich, select apps from the far right menu.
  2. Then select discover apps on the top right.
  3. Search Immich in the search bar.
  4. Select It.
  5. Then select Install Immich
install immich on truenas

Configure the Install Settings on TrueNAS for Immich​

Here is a list of the setting we MUST change for Immich to work, if you miss some of these settings, it may fail to install and turn on.

Application Name​

  1. Name your applicaiton

    Immich Configuration​

  2. Select your timezone

  3. Select enable machine learning leave as default machine learning image unless you have an Nvidia GPU installed then you can select cuda machine learning iamge

  4. Set a database password.

  5. Set a redis password

  6. Select SSD or HDD under database storage type+

immich configuration settings on truenas

Network Configuration​

  1. Select add under Host IPs
immich network configuration settings on truenas

Storage Configuration​

make sure under type you select host path. 8. Select your dataset for uploads under Data Storage 9. Select your dataset pgdata under Postgres Data Storage 10. Select Automatic Permissions under PostGres Data Storage

immich storage configuration on truenas settings

Resource Configuration​

Immich reccomends at least 8 threads and 6Gb of Ram. Set these below. As you can see 2 CPU threads and roughly 8 Gbs of RAM has been working fine for me. 11. Set CPUs 12. Set Memory.

resource configuration settigns for immich on truenas

Then when you are done select Install at the bottom.

Logining into Immich​

To login to Immich you will go to the IP address of your TrueNAS Machine and the port 30041.

http://<ip address>:30041

Go ahead and create an account and login to your Immich cloud environment. If you would like to understand how to use Immich more, continue watching your videos linked at the top of this article where we will show you how to use it with your phone.

Using Immich on your phone​

One last thing, if you want Immich to upload photos automatically from your sleected albums, you need to go into your phone settings, search for Immich, then go to the battery settings and turn it to unrestricted. If you do not do this, Immich will be closed by your phones operating system and be unable to run backups automatically.

Follow Us on Social Media​

YouTube
Discord
Patreon
Reddit
Rumble