HexOS/TrueNAS - fail to start without error after update
Hello,
I’m running Immich on HexOS and recently updated my installation. Since the update, the deployment restarts every few minutes. During these restart cycles, the application is not accessible.
From what I can tell, there are no error messages, but my technical knowledge is limited.
Could someone please advise me on how to troubleshoot or resolve this issue?
Thanks in advance!
47 Replies
:wave: Hey @Apfelholz,
Thanks for reaching out to us. Please carefully read this message and follow the recommended actions. This will help us be more effective in our support effort and leave more time for building Immich :immich:.
References
- Container Logs:
docker compose logs
docs
- Container Status: docker ps -a
docs
- Reverse Proxy: https://immich.app/docs/administration/reverse-proxy
- Code Formatting https://support.discord.com/hc/en-us/articles/210298617-Markdown-Text-101-Chat-Formatting-Bold-Italic-Underline#h_01GY0DAKGXDEHE263BCAYEGFJA
Checklist
I have...
1. :ballot_box_with_check: verified I'm on the latest release(note that mobile app releases may take some time).
2. :ballot_box_with_check: read applicable release notes.
3. :blue_square: reviewed the FAQs for known issues.
4. :blue_square: reviewed Github for known issues.
5. :blue_square: tried accessing Immich via local ip (without a custom reverse proxy).
6. :blue_square: uploaded the relevant information (see below).
7. :blue_square: tried an incognito window, disabled extensions, cleared mobile app cache, logged out and back in, different browsers, etc. as applicable
(an item can be marked as "complete" by reacting with the appropriate number)
Information
In order to be able to effectively help you, we need you to provide clear information to show what the problem is. The exact details needed vary per case, but here is a list of things to consider:
- Your docker-compose.yml and .env files.
- Logs from all the containers and their status (see above).
- All the troubleshooting steps you've tried so far.
- Any recent changes you've made to Immich or your system.
- Details about your system (both software/OS and hardware).
- Details about your storage (filesystems, type of disks, output of commands like fdisk -l
and df -h
).
- The version of the Immich server, mobile app, and other relevant pieces.
- Any other information that you think might be relevant.
Please paste files and logs with proper code formatting, and especially avoid blurry screenshots.
Without the right information we can't work out what the problem is. Help us help you ;)
If this ticket can be closed you can use the /close
command, and re-open it later if needed.Can you define "recently"? Do you knwo on which version on Immich you were before?
Do you know how to access the logs of the Immich app within the TrueNAS interface?
Recently means about an hour ago. Unfortunately, I have no idea which version I was on before. I searched for how to access the logs in the TrueNAS interface, but I couldn’t find anything.
Are you able to go inside the TrueNAS interface itself? I can guide you from there
But I would need to know if you know how to access it
yes the TrueNAS interface is no problem
( sorry if semm a littel rude, my englisch isent the best)
No problem for that, it's not my 1st language either
Ok so there is the "Apps panel"
There you should see Immich
If you click on it, "widgets" should appear
One of them is the worflow one, and it should list multiple services
server
postgres
machine-learning…
yes

on server, click on the third icon
It should show you the logs of it
Share that if you can access them
This is looping
Ooooh ok
So you did not update the app for a relatively long time :/
yesssss 😅 have not been in town for a supsetial amount of time
The issue is that you first need to start Immich with an older version than 1.137 (1.132 or above)
ok, dose make sens.. but how? 😅
Well, with truenas it's a bit harder, you have to change the app to a custom YAML, but I woudl do multiple things before that
What I would suggest
0) Rollback to the working version if possible
1) Have sure to have a backup of your photos and the Immich database
2) Edit the Immich app, and take a screenshot of every settings (as well as the passwords) so you can set Immich the right way again (it might be possible that hexos manages that but I'm not sure)
3) Change the Immich app to a custom yaml (there is a button for that after clicking on the 3 dots menu next to Immich)
4) there specify the version 1.132
5) Deploy the app
6) verify that it works, then edit again the YAML to change the version to the latest
7) Either keep it this way, but you'll have to do manual updates (I think) or reinstall the app using the settings from 2)
I'm sorry but I've work to do until the 18th so it will possibly be hard for me to provide a lot of assistance
Or if you have a backup of all your photos and don't mind starting fresh and upload everything again, you could delete the app and removing its dataset and reinstall it within HexOs
There might be another way also, now that I think about it
but I''m not sure at all it could work
Is to deploy a manual immich pointing it to your existing one and use it to upgrade everything
Thanks very much for the assistance. If you find time to help, I think the parts where I have the least knowledge (or no idea how to do them yet) are the rollback and making a good backup of the database (I’m not really sure what exactly that includes).
you might already have backups, you would have to check in the immich datast if the backups folder exists and contains something
I shood have every photo seaware else but to be save it wood be grate to have the database (its somwot of my backop 😅 )
I will try to do taht
You will have to use the terminal
It's probably
cd /mnt/YOURPOOL/Applications/Immich/data/backups
this dosent sem to exsist:

what if you do:
ls -la
I might open an Issue on the TrueNAS side the evening to ask if there would be an easy fix on their side that could help you (and other)
I think that the custom app would be the best way to do it without breaking anything
It evens look like truenas can update them
This is the result. I understood everything else somewhat, but I can’t make sense of this part.

schood I wait for taht before taking any braking action ?
Oooh, yeah, that's the old datastructure
Yeah, I mean if you don't mind waiting I could help you more after the 18th
no problem, rely grateful for the help and willing to wait. (shood I contact you again after the 18. ?)
Yes you can ping me if no one else helped you with the issue and I've not replied
Ok, so I've some time this week if you haven't fix the issue
First get the old version of Immich you were on:
Apps -> Configuration -> Manage Container Images
There should be a list of all container image, and Immich should be there multiple times with a version number like in the picture

Thank you very much, I do still need the help 😅 found this:

Lmao, 1 version later, you would have had nothing to do
So I would change the Immich app to a custom app
First, edit the Immich App and take screenshots of the configuration and save the passwords somewhere
Then Next to the edit button of the Immich app -> 3 dots and there you can convert to custom app
Afterwards, you edit the custom app, replcaing the immich-server enad immich-machine-learning numbers with your most recent old version so use immich-server:v1.131.1 instead of v1.137.3
lmk if you need more help/guidance
After that, you'll have to start immich once with this old version (to make sure it works)
Then change the version to v1.132.0
And then you can either continue to upgrade to v1.137.3
Or you could detele and reinstall de app (I'll explain it if it what you want)
I cant for my live find those 3 dots 😅 ?

What the…
Try to update first?
Immich won't work, but this is where it should be -_-

will do
(Even whn the app is not running I've the three dots)
the ubdate button also gives no other option ...

No?
I mean that is the same version to upgrade to
so just click upgrade
I ment the option for a coutom app
Oh yeah, but what I hope is that the button will appear after upgrade
I will have a look next time there is an update for one of my app though, that's seems weird that is not possible to change it
Did it work?
sort of XD

Could that be an HexOS thing?
Can you install another Immich from Truenas itself?
I have no clue
(leave Ix-volumes, just set a random password and change the exposed port)
I hope you have this button

wood probbaly need some more instructions but yes
Voice chat?
semms good
You can /close if the issue is solved btw
This thread has been closed. To re-open, use the button below.