How do I self-host Immich?

Immich can be deployed using Docker Compose. The AltStack provides a production-ready configuration that you can deploy on your own server. Simply copy the configuration and run it on any machine with Docker installed.

Is Immich free to self-host?

Yes, Immich is open source under the AGPL-3.0 and free to self-host. Your only costs are the server infrastructure. A basic cloud VPS starts at around $5-10/month.

What programming language is Immich built with?

Immich is built with TypeScript. It has 116,178 stars on GitHub, indicating strong community adoption and support.

Back to Self-Hosted Stacks

Deploy Immich

High performance self-hosted photo and video management solution. Direct alternative to Google Photos.

Quick Start

Create a directory

mkdir immich-self-hosted && cd immich-self-hosted

Create config file

Copy the content from the Config tab below into a file named docker-compose.yml

Deploy

docker compose up -d

Fast Track

Deploy Immich in Minutes

Use our optimized Docker templates to deploy Immich on any cloud provider. Get $200 in free credit to start on DigitalOcean.

Start with free creditDeploy on DigitalOcean

$200

Metadata

License

AGPL-3.0

Language

TypeScript

Last Updated

10/14/2026

Configuration

yaml



# -------------------------------------------------------------------------
# 🚀 Created and distributed by The AltStack
# 🌍 https://thealtstack.com
# -------------------------------------------------------------------------

version: '3.8'

services:
  web:
    image: ghcr.io/immich-app/immich-server:release
    container_name: immich-server
    restart: unless-stopped
    depends_on:
      - db
      - redis
    ports:
      - "2283:2283"
    environment:
      - DB_HOSTNAME=db
      - REDIS_HOSTNAME=redis
    volumes:
      - ./photos:/usr/src/app/upload

  db:
    image: postgres:15-alpine
    container_name: immich-db
    restart: unless-stopped
    environment:
      - POSTGRES_USER=immich
      - POSTGRES_PASSWORD=immich
      - POSTGRES_DB=immich

  redis:
    image: redis:alpine
    container_name: immich-redis
    restart: unless-stopped

Community Notes

Help others by adding context, corrections, or warnings about this tool. Sign in to contribute.

No community notes yet. Be the first to add context.