{"id":95760,"date":"2025-09-25T15:57:36","date_gmt":"2025-09-25T10:27:36","guid":{"rendered":"https:\/\/www.seminarsonly.com\/news\/?p=95760"},"modified":"2025-09-25T16:09:03","modified_gmt":"2025-09-25T10:39:03","slug":"immich-docker-compose-official-docker-compose-setup","status":"publish","type":"post","link":"https:\/\/seminarsonly.com\/news\/immich-docker-compose-official-docker-compose-setup\/","title":{"rendered":"Immich Docker Compose | Official Docker Compose Setup"},"content":{"rendered":"

Immich Docker Compose setup is the recommended way to run Immich for photo and video backup in production. Docker Compose is the recommended method to run Immich in production.<\/em><\/span><\/h3>\n

Here\u2019s how you can deploy Immich<\/strong> using Docker Compose (official recommended method) plus tips & caveats:<\/p>\n

\n

\ud83d\udee0 Official Docker Compose Setup<\/span><\/h2>\n

According to the Immich docs: \u201cDocker Compose is the recommended method to run Immich in production.\u201d<\/p>\n

Here are the steps:<\/p>\n

Step 1: Prepare a directory & get files<\/span><\/h3>\n
\n
mkdir<\/span> immich-app
\ncd<\/span> immich-app
\n<\/code><\/div>\n<\/div>\n

Download the docker-compose.yml<\/code> and the environment example:<\/p>\n

\n
wget -O docker-compose.yml https:\/\/github.com\/immich-app\/immich\/releases\/latest\/download\/docker-compose.yml
\nwget -O .env<\/span> https:\/\/github.com\/immich-app\/immich\/releases\/latest\/download\/example.env
\n<\/code><\/div>\n<\/div>\n

If you downloaded manually via browser, rename example.env<\/code> to .env<\/code>.<\/p>\n

Also Read : Charlie Kirk on a Coin<\/a><\/h3>\n

Step 2: Edit .env<\/code><\/span><\/h3>\n

Open .env<\/code> and set the variables you need. Some key ones:<\/p>\n

\n
\n\n\n\n\n\n\n\n\n\n
Variable<\/th>\nPurpose<\/th>\nDefault \/ Notes<\/th>\n<\/tr>\n<\/thead>\n
UPLOAD_LOCATION<\/code><\/td>\nPath on the host where photos\/videos will be stored<\/td>\ne.g. .\/library<\/code><\/td>\n<\/tr>\n
DB_DATA_LOCATION<\/code><\/td>\nPath on host for PostgreSQL data<\/td>\ne.g. .\/postgres<\/code><\/td>\n<\/tr>\n
IMMICH_VERSION<\/code><\/td>\nWhich version tag to use<\/td>\ndefault \u201crelease\u201d<\/td>\n<\/tr>\n
DB_PASSWORD<\/code>, DB_USERNAME<\/code>, DB_DATABASE_NAME<\/code><\/td>\nDB credentials<\/td>\nchange DB_PASSWORD<\/code> to something secure (avoid special characters)<\/td>\n<\/tr>\n
TZ<\/code><\/td>\nTimezone<\/td>\nuncomment & set if desired<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<\/div>\n

If you change environment vars, you\u2019ll need to recreate containers so they pick up the new values.<\/p>\n

Step 3: Start the stack<\/span><\/h3>\n

Run:<\/p>\n

\n
docker compose up -d
\n<\/code><\/div>\n<\/div>\n

This will pull the necessary images and bring up all relevant services (server, Redis, PostgreSQL, machine learning, etc.)<\/p>\n

Note: The command is docker compose<\/code>, not docker\u2011compose<\/code> (depending on your Docker version).<\/p>\n

If you get errors like unknown shorthand flag: 'd'<\/code>, your Docker command version is misaligned (e.g. using older Docker). Use the proper Docker engine install for your OS.<\/p>\n

One known issue: some users see errors like can't set healthcheck.start_interval<\/code> if their Docker engine version is older (pre v25). In that case, comment out or remove that healthcheck line under the database<\/code> service in docker-compose.yml<\/code>.<\/p>\n

\n

\u26a0 Caveats and Tips from Community & Issues<\/span><\/h2>\n
    \n
  • \n

    If you already have an existing Docker Compose setup with services (databases, Redis, etc.), conflicts may arise. For example, some people report conflicts due to generic service names like database<\/code>, redis<\/code>, or environment variables that collide.<\/p>\n<\/li>\n

  • \n

    Some have had to rewrite parts of the official compose file to integrate with existing stacks.<\/p>\n<\/li>\n

  • \n

    On Unraid, people sometimes need to remove or disable healthcheck<\/code> blocks because their Docker engine version doesn\u2019t support certain healthcheck parameters.<\/p>\n<\/li>\n

  • \n

    A very common error is \u201cUnable to connect to database \/ getaddrinfo ENOTFOUND database\u201d \u2014 that usually indicates network or host name mismatches (i.e. your DB_HOSTNAME<\/code> not matching service name or network).<\/p>\n<\/li>\n

  • \n

    When upgrading Immich, many users just update the docker-compose.yml<\/code> and .env<\/code> based on the breaking changes list, rather than fully replacing their files each time.<\/p>\n<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"

    Immich Docker Compose setup is the recommended way to run Immich for photo and video backup in production. Docker Compose is the recommended method to run Immich in production. Here\u2019s…<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[],"class_list":["post-95760","post","type-post","status-publish","format-standard","hentry","category-news"],"yoast_head":"\nImmich Docker Compose | Official Docker Compose Setup - Seminarsonly.com<\/title>\n<meta name=\"description\" content=\"Immich Docker Compose setup is the recommended way to run Immich for photo and video backup in production. Docker Compose is the recommended method to run Immich in production.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/seminarsonly.com\/news\/immich-docker-compose-official-docker-compose-setup\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Immich Docker Compose | Official Docker Compose Setup\" \/>\n<meta property=\"og:description\" content=\"Immich Docker Compose setup is the recommended way to run Immich for photo and video backup in production. Docker Compose is the recommended method to run Immich in production.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/seminarsonly.com\/news\/immich-docker-compose-official-docker-compose-setup\/\" \/>\n<meta property=\"og:site_name\" content=\"Seminarsonly.com\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/facebook.com\/seminarsonly\" \/>\n<meta property=\"article:published_time\" content=\"2025-09-25T10:27:36+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2025-09-25T10:39:03+00:00\" \/>\n<meta name=\"author\" content=\"Freddy John\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@seminarsonly\" \/>\n<meta name=\"twitter:site\" content=\"@seminarsonly\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Freddy John\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/seminarsonly.com\/news\/immich-docker-compose-official-docker-compose-setup\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/seminarsonly.com\/news\/immich-docker-compose-official-docker-compose-setup\/\"},\"author\":{\"name\":\"Freddy John\",\"@id\":\"https:\/\/seminarsonly.com\/news\/#\/schema\/person\/75cf706896b7210fb0a84651adc258bd\"},\"headline\":\"Immich Docker Compose | Official Docker Compose Setup\",\"datePublished\":\"2025-09-25T10:27:36+00:00\",\"dateModified\":\"2025-09-25T10:39:03+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/seminarsonly.com\/news\/immich-docker-compose-official-docker-compose-setup\/\"},\"wordCount\":401,\"commentCount\":0,\"articleSection\":[\"news\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/seminarsonly.com\/news\/immich-docker-compose-official-docker-compose-setup\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/seminarsonly.com\/news\/immich-docker-compose-official-docker-compose-setup\/\",\"url\":\"https:\/\/seminarsonly.com\/news\/immich-docker-compose-official-docker-compose-setup\/\",\"name\":\"Immich Docker Compose | Official Docker Compose Setup - Seminarsonly.com\",\"isPartOf\":{\"@id\":\"https:\/\/seminarsonly.com\/news\/#website\"},\"datePublished\":\"2025-09-25T10:27:36+00:00\",\"dateModified\":\"2025-09-25T10:39:03+00:00\",\"author\":{\"@id\":\"https:\/\/seminarsonly.com\/news\/#\/schema\/person\/75cf706896b7210fb0a84651adc258bd\"},\"description\":\"Immich Docker Compose setup is the recommended way to run Immich for photo and video backup in production. Docker Compose is the recommended method to run Immich in production.\",\"breadcrumb\":{\"@id\":\"https:\/\/seminarsonly.com\/news\/immich-docker-compose-official-docker-compose-setup\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/seminarsonly.com\/news\/immich-docker-compose-official-docker-compose-setup\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/seminarsonly.com\/news\/immich-docker-compose-official-docker-compose-setup\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/seminarsonly.com\/news\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Immich Docker Compose | Official Docker Compose Setup\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/seminarsonly.com\/news\/#website\",\"url\":\"https:\/\/seminarsonly.com\/news\/\",\"name\":\"Seminarsonly.com\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/seminarsonly.com\/news\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/seminarsonly.com\/news\/#\/schema\/person\/75cf706896b7210fb0a84651adc258bd\",\"name\":\"Freddy John\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/secure.gravatar.com\/avatar\/671d452f5fe9027ab894cbed50911cc764b2c16878222070bf044f21705d4c94?s=96&d=mm&r=g\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/671d452f5fe9027ab894cbed50911cc764b2c16878222070bf044f21705d4c94?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/671d452f5fe9027ab894cbed50911cc764b2c16878222070bf044f21705d4c94?s=96&d=mm&r=g\",\"caption\":\"Freddy John\"},\"sameAs\":[\"https:\/\/seminarsonly.com\/news\"],\"url\":\"https:\/\/seminarsonly.com\/news\/author\/anupvnaick_51wq8y4s\/\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Immich Docker Compose | Official Docker Compose Setup - Seminarsonly.com","description":"Immich Docker Compose setup is the recommended way to run Immich for photo and video backup in production. Docker Compose is the recommended method to run Immich in production.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/seminarsonly.com\/news\/immich-docker-compose-official-docker-compose-setup\/","og_locale":"en_US","og_type":"article","og_title":"Immich Docker Compose | Official Docker Compose Setup","og_description":"Immich Docker Compose setup is the recommended way to run Immich for photo and video backup in production. Docker Compose is the recommended method to run Immich in production.","og_url":"https:\/\/seminarsonly.com\/news\/immich-docker-compose-official-docker-compose-setup\/","og_site_name":"Seminarsonly.com","article_publisher":"https:\/\/facebook.com\/seminarsonly","article_published_time":"2025-09-25T10:27:36+00:00","article_modified_time":"2025-09-25T10:39:03+00:00","author":"Freddy John","twitter_card":"summary_large_image","twitter_creator":"@seminarsonly","twitter_site":"@seminarsonly","twitter_misc":{"Written by":"Freddy John","Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/seminarsonly.com\/news\/immich-docker-compose-official-docker-compose-setup\/#article","isPartOf":{"@id":"https:\/\/seminarsonly.com\/news\/immich-docker-compose-official-docker-compose-setup\/"},"author":{"name":"Freddy John","@id":"https:\/\/seminarsonly.com\/news\/#\/schema\/person\/75cf706896b7210fb0a84651adc258bd"},"headline":"Immich Docker Compose | Official Docker Compose Setup","datePublished":"2025-09-25T10:27:36+00:00","dateModified":"2025-09-25T10:39:03+00:00","mainEntityOfPage":{"@id":"https:\/\/seminarsonly.com\/news\/immich-docker-compose-official-docker-compose-setup\/"},"wordCount":401,"commentCount":0,"articleSection":["news"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/seminarsonly.com\/news\/immich-docker-compose-official-docker-compose-setup\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/seminarsonly.com\/news\/immich-docker-compose-official-docker-compose-setup\/","url":"https:\/\/seminarsonly.com\/news\/immich-docker-compose-official-docker-compose-setup\/","name":"Immich Docker Compose | Official Docker Compose Setup - Seminarsonly.com","isPartOf":{"@id":"https:\/\/seminarsonly.com\/news\/#website"},"datePublished":"2025-09-25T10:27:36+00:00","dateModified":"2025-09-25T10:39:03+00:00","author":{"@id":"https:\/\/seminarsonly.com\/news\/#\/schema\/person\/75cf706896b7210fb0a84651adc258bd"},"description":"Immich Docker Compose setup is the recommended way to run Immich for photo and video backup in production. Docker Compose is the recommended method to run Immich in production.","breadcrumb":{"@id":"https:\/\/seminarsonly.com\/news\/immich-docker-compose-official-docker-compose-setup\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/seminarsonly.com\/news\/immich-docker-compose-official-docker-compose-setup\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/seminarsonly.com\/news\/immich-docker-compose-official-docker-compose-setup\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/seminarsonly.com\/news\/"},{"@type":"ListItem","position":2,"name":"Immich Docker Compose | Official Docker Compose Setup"}]},{"@type":"WebSite","@id":"https:\/\/seminarsonly.com\/news\/#website","url":"https:\/\/seminarsonly.com\/news\/","name":"Seminarsonly.com","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/seminarsonly.com\/news\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/seminarsonly.com\/news\/#\/schema\/person\/75cf706896b7210fb0a84651adc258bd","name":"Freddy John","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/671d452f5fe9027ab894cbed50911cc764b2c16878222070bf044f21705d4c94?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/671d452f5fe9027ab894cbed50911cc764b2c16878222070bf044f21705d4c94?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/671d452f5fe9027ab894cbed50911cc764b2c16878222070bf044f21705d4c94?s=96&d=mm&r=g","caption":"Freddy John"},"sameAs":["https:\/\/seminarsonly.com\/news"],"url":"https:\/\/seminarsonly.com\/news\/author\/anupvnaick_51wq8y4s\/"}]}},"_links":{"self":[{"href":"https:\/\/seminarsonly.com\/news\/wp-json\/wp\/v2\/posts\/95760","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/seminarsonly.com\/news\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/seminarsonly.com\/news\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/seminarsonly.com\/news\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/seminarsonly.com\/news\/wp-json\/wp\/v2\/comments?post=95760"}],"version-history":[{"count":0,"href":"https:\/\/seminarsonly.com\/news\/wp-json\/wp\/v2\/posts\/95760\/revisions"}],"wp:attachment":[{"href":"https:\/\/seminarsonly.com\/news\/wp-json\/wp\/v2\/media?parent=95760"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/seminarsonly.com\/news\/wp-json\/wp\/v2\/categories?post=95760"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/seminarsonly.com\/news\/wp-json\/wp\/v2\/tags?post=95760"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}