Setting up immich within UGOS through Docker
I am very new with Docker and UGOS and really anything relating to running apps off my NAS. I'm trying to follow the directions for installing Immich using Docker compose and am running into some issues.
What I've done so far:
1. I've downloaded the yml and env files from the website.
2. I changed the timezone and added a password onto the example.env file and renamed it.
3. I then put both files in the folder location in my NAS.
4. Through the docker app in UGOS, I created a new project called immich-app
5. in the compose configuration, I imported the yml file in the folder and added the new env file name under env_file: on lines 23 and 44 to the name of my env file.
6. I hit deploy and I get the attached errors.
Help?

19 Replies
:wave: Hey @pibedavid,
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_01GY0DAKGXDEHE263BCAYEGFJAChecklist
I have...
1. :blue_square: verified I'm on the latest release(note that mobile app releases may take some time).
2. :blue_square: 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.GitHub
immich-app immich · Discussions
Explore the GitHub Discussions forum for immich-app immich. Discuss code, ask questions & collaborate with the developer community.
FAQ | Immich
User
GitHub
Issues · immich-app/immich
High performance self-hosted photo and video management solution. - Issues · immich-app/immich
details of step 4 and 5 would be beneficial. Screenshots would work as well.
Please provide a copy of your docker config file and your env file
OK. here are my files. i changed the password on the env file just now
because you named the env file something other than
.env
you need to specify it in all related containers I believeso i should just delete the name? if i just leave those lines as .env as opposed to galindoimmich.env then it should be fine?
or should i rename then env back to what it was as example.env?
rename the env file to
.env
hm. just tried that. wasn't sure you were able to do just name it nothing
ok. so when i did that, i reuploaded it to the folder location
but although the message said it updloaded fine, it's not in the actual folder. just tried to do it multiple times and it says it uploads fine, but then doesn't show it
so then i just re-deployed anyway and i get the same errors as my original pic
alternatively try specifiying the explicit file in each container
ok here we go
The . At the beginning tends to hide it. Do on the directory and it should show
it did it i think. it's doing a deployment log
and pulling immich server

this mean it worked?
Looks like it bud
ok. i guess it's running now. alright. 1st step done. oh dang. i forgot to change the pw. can i do change it later?
was gonna go onto the next steps from the website lol
You are so early in the process. You can start over but be sure to delete the database before you deploy again
Since this is your first run I wouldnt commit yourself to immich just yet btw
Deploy and play with it. Hell try everything you can think of to break immich
Learn from your mistakes and re deploy again
Once you can deploy immich by memory the next thing is learning how to properly do backups and restoring from backups
Once you can do both those things from memory then I would run immich as your primary photo management
OK thank you!