{
  "manifest_version": "1",
  "slug": "immich",
  "title": "Immich",
  "headline": "Self-host Immich",
  "description": "Run Immich with Docker Compose on an exe.dev VM: a private photo library behind exe.dev login, phone backup with a VM token, faces and smart search on CPU, and backups.",
  "category": "media",
  "tags": [
    "google photos alternative",
    "photo backup",
    "immich docker",
    "immich self-host",
    "docker compose",
    "postgresql",
    "face recognition"
  ],
  "url": "https://exe.dev/deploy/immich",
  "markdown_url": "https://exe-staging.dev/deploy/immich.md",
  "upstream": {
    "website": "https://immich.app",
    "source": "https://github.com/immich-app/immich",
    "docs": "https://docs.immich.app",
    "license": "AGPL-3.0"
  },
  "example_vm_name": "my-immich",
  "time": "15 minutes",
  "stack": [
    {
      "name": "Immich server 3.4",
      "detail": "ghcr.io/immich-app/immich-server, Immich's own docker-compose.yml, published on port 8000",
      "port": 8000,
      "data": "~/immich/library"
    },
    {
      "name": "Machine learning",
      "detail": "immich-machine-learning on CPU; smart search, faces and OCR",
      "data": "model-cache volume"
    },
    {
      "name": "PostgreSQL 14 with VectorChord",
      "detail": "Immich's postgres image",
      "data": "~/immich/postgres"
    },
    {
      "name": "Valkey",
      "detail": "The job queue"
    }
  ],
  "access": [
    {
      "url": "https://my-immich.exe.xyz/",
      "who": "private",
      "what": "The Immich web app and API, behind exe.dev login and Immich's own accounts"
    },
    {
      "url": "https://my-immich.exe.xyz/",
      "who": "shared",
      "what": "The same, for the Immich mobile app with a VM token in a custom header"
    }
  ],
  "delivers": [
    "Immich 3.4 on Docker Compose, with Immich's own compose file pinned to one release.",
    "The web app at https://my-immich.exe.xyz/, private behind exe.dev login, ready for the owner's admin account.",
    "The library and database on the VM's disk, with room to grow and Immich's nightly database dumps on.",
    "Everything starts again after a reboot."
  ],
  "deployable": true,
  "deploy": {
    "new_vm_url": "https://exe-staging.dev/new?prompt=Set%20up%20Immich%20on%20this%20VM%20by%20following%20the%20exe.dev%20recipe%20at%20https%3A%2F%2Fexe-staging.dev%2Fdeploy%2Fimmich.md%3Fvia%3Ddeploy%20from%20top%20to%20bottom.%0A%0AThe%20recipe%27s%20example%20VM%20name%20is%20my-immich.%20This%20VM%27s%20name%20is%20the%20output%20of%20%60hostname%60%3A%20use%20it%20wherever%20the%20recipe%20writes%20my-immich.%20Skip%20the%20step%20that%20creates%20the%20VM%3B%20you%20are%20on%20it.%0A%0AThis%20recipe%20needs%20a%20100GB%20disk%2C%20and%20a%20new%20VM%27s%20may%20be%20smaller.%20Before%20you%20install%20anything%2C%20run%20%60df%20-h%20%2F%60.%20If%20its%20size%20is%20under%2090G%2C%20stop%20and%20ask%20me%20to%20grow%20the%20disk%2C%20either%20with%20this%20link%3A%20https%3A%2F%2Fexe.dev%2Fsuggest%3Fcommand%3Dresize%2520my-immich%2520--disk%253D100GB%20or%2C%20on%20my%20computer%2C%20with%20%60ssh%20exe.dev%20resize%20my-immich%20--disk%3D100GB%60.%20When%20I%20say%20it%27s%20done%2C%20run%20%60sudo%20resize2fs%20%22%24%28findmnt%20-no%20SOURCE%20%2F%29%22%60%2C%20check%20%60df%20-h%20%2F%60%20again%2C%20and%20carry%20on.%0A%0AYou%20are%20done%20when%20all%20of%20these%20are%20true.%20Check%20each%20one%20yourself%3A%0A-%20Immich%203.4%20on%20Docker%20Compose%2C%20with%20Immich%27s%20own%20compose%20file%20pinned%20to%20one%20release.%0A-%20The%20web%20app%20at%20https%3A%2F%2Fmy-immich.exe.xyz%2F%2C%20private%20behind%20exe.dev%20login%2C%20ready%20for%20the%20owner%27s%20admin%20account.%0A-%20The%20library%20and%20database%20on%20the%20VM%27s%20disk%2C%20with%20room%20to%20grow%20and%20Immich%27s%20nightly%20database%20dumps%20on.%0A-%20Everything%20starts%20again%20after%20a%20reboot.%0A%0ARead%20the%20whole%20recipe%2C%20including%20the%20closed%20details.%20For%20initial%20setup%2C%0Afollow%20%22Install%20by%20hand%22%20first%2C%20from%20%22Check%20the%20disk%22%20on%20%28skip%20creating%0Athe%20VM%29.%20The%20walkthrough%20at%20the%20top%20is%20for%20the%20owner%20afterwards.%0AWork%20as%20exedev%20in%20~%2Fimmich.%20Never%20overwrite%20an%20existing%20.env.%20Don%27t%20create%0Athe%20Immich%20admin%20account%3A%20the%20first%20person%20to%20open%20the%20web%20app%20becomes%0Aadmin%2C%20and%20that%20must%20be%20the%20owner.%20Don%27t%20make%20the%20VM%20public%2C%20upload%0Aphotos%2C%20generate%20tokens%20or%20change%20Immich%20settings.%20Don%27t%20run%20Restore%20or%0AUpdate.%0AIf%20the%20disk%20is%20under%2090%20GB%2C%20stop%20and%20give%20the%20owner%20a%20suggest%20link%20to%0Aresize%20it%2C%20as%20the%20recipe%20says%2C%20before%20installing.%0AVerify%20docker.service%20is%20enabled%2C%20all%20four%20containers%20are%20up%20and%0Ahealthy%2C%20and%20curl%20localhost%3A8000%2Fapi%2Fserver%2Fping%20returns%20pong.%20Do%20not%0Areboot.%20Finish%20by%20sending%20the%20owner%20to%20https%3A%2F%2F%3Cvm%3E.exe.xyz%2F%20to%20create%0Athe%20admin%20account%2C%20and%20point%20them%20to%20%22Back%20up%20your%20phone%22.%0A%0AFinish%20with%20the%20URLs%20I%20should%20open.%0A",
    "disk": "100GB",
    "terminal": "curl -fsSL https://exe-staging.dev/deploy/immich/prompt.txt | ssh exe.dev new --disk=100GB --prompt=/dev/stdin",
    "prompt": "Set up Immich on this VM by following the exe.dev recipe at https://exe-staging.dev/deploy/immich.md?via=deploy from top to bottom.\n\nThe recipe's example VM name is my-immich. This VM's name is the output of `hostname`: use it wherever the recipe writes my-immich. Skip the step that creates the VM; you are on it.\n\nThis recipe needs a 100GB disk, and a new VM's may be smaller. Before you install anything, run `df -h /`. If its size is under 90G, stop and ask me to grow the disk, either with this link: https://exe.dev/suggest?command=resize%20my-immich%20--disk%3D100GB or, on my computer, with `ssh exe.dev resize my-immich --disk=100GB`. When I say it's done, run `sudo resize2fs \"$(findmnt -no SOURCE /)\"`, check `df -h /` again, and carry on.\n\nYou are done when all of these are true. Check each one yourself:\n- Immich 3.4 on Docker Compose, with Immich's own compose file pinned to one release.\n- The web app at https://my-immich.exe.xyz/, private behind exe.dev login, ready for the owner's admin account.\n- The library and database on the VM's disk, with room to grow and Immich's nightly database dumps on.\n- Everything starts again after a reboot.\n\nRead the whole recipe, including the closed details. For initial setup,\nfollow \"Install by hand\" first, from \"Check the disk\" on (skip creating\nthe VM). The walkthrough at the top is for the owner afterwards.\nWork as exedev in ~/immich. Never overwrite an existing .env. Don't create\nthe Immich admin account: the first person to open the web app becomes\nadmin, and that must be the owner. Don't make the VM public, upload\nphotos, generate tokens or change Immich settings. Don't run Restore or\nUpdate.\nIf the disk is under 90 GB, stop and give the owner a suggest link to\nresize it, as the recipe says, before installing.\nVerify docker.service is enabled, all four containers are up and\nhealthy, and curl localhost:8000/api/server/ping returns pong. Do not\nreboot. Finish by sending the owner to https://\u003cvm\u003e.exe.xyz/ to create\nthe admin account, and point them to \"Back up your phone\".\n\nFinish with the URLs I should open.\n",
    "prompt_url": "https://exe-staging.dev/deploy/immich/prompt.txt"
  },
  "published": "2026-11-21",
  "updated": "2026-11-21",
  "verified": "2026-11-21",
  "related": [
    "docker-compose",
    "postgres",
    "s3-storage",
    "linux-desktop",
    "n8n-2",
    "claude-code"
  ],
  "alternatives": [
    "Google Photos",
    "iCloud Photos",
    "Amazon Photos"
  ]
}
