Immich Self-hosted photo and video management solution Easily back up, organize, and manage your photos on your own server Immich helps you browse, search and organize your photos and videos with ease, without sacrificing your privacy
Quick start | Immich Quick start Here is a quick, no-choices path to install Immich and take it for a test drive Once you've tried it, you might use one of the many other ways to install and use it Requirements A system with at least 4GB of RAM and 2 CPU cores Docker For a more detailed list of requirements, see the requirements page
The Immich CLI | Immich Immich has a command line interface (CLI) that allows you to perform certain actions from the command line
Upgrading | Immich When a new version of Immich is released, you should read the release notes and account for any breaking changes noted (as mentioned above) If you use IMMICH_VERSION in your env file, it will need to be updated to the latest or desired version After that, the application can be upgraded and restarted with the following commands, run in the directory with the docker-compose yml file:
Comparison | Immich Comparison If you're new here and came from other asset self-hosting alternatives you might want to look at a comparison between Immich and your current solution Here you can see a comparison between the various OpenSource Photo Libraries including Immich
Download | Immich Download Immich app and start backing up your photos and videos securely to your own server
Docker Compose [Recommended] | Immich Docker Compose is the recommended method to run Immich in production Below are the steps to deploy Immich with Docker Compose
Requirements | Immich Discover the hardware and software requirements needed to install and run Immich effectively
Scaling Immich | Immich Scaling Immich Immich is built with modern deployment practices in mind, and the backend is designed to be able to run multiple instances in parallel When doing this, the only requirement you need to be aware of is that every instance needs to be connected to the shared infrastructure That means they should all have access to the same Postgres and Redis instances, and have the same files
Portainer | Immich Install Immich using Portainer's Stack feature Portainer Install Immich using Portainer's Stack feature Go to " Stacks " in the left sidebar Click on " Add stack " Give the stack a name (i e immich), and select " Web Editor " as the build method Copy the content of the docker-compose yml file from the GitHub repository Replace env with stack env for all containers that need to use