お知らせ

Immichサーバー導入手順

Docker Compose [推奨]

本番環境でImmichを実行するには、Docker Composeが推奨されています。以下は、ImmichをDocker Composeでデプロイするための手順です。

ステップ1 – 必要なファイルのダウンロード

任意のディレクトリを作成し、ファイルを保存してください。
例：{./immich-app}、{docker-compose.yml}{.env}

作成したディレクトリに移動してください

mkdir ./immich-app
cd ./immich-app

以下のコマンドを実行して{docker-compose.yml}と{example.env}をダウンロードしてください:

{docker-compose.yml}ファイルを取得する

wget -O docker-compose.yml https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml

{.env}ファイルを取得する

wget -O .env https://github.com/immich-app/immich/releases/latest/download/example.env

または、ブラウザからこれら2つのファイルをダウンロードし、作成したディレクトリに移動し、その場合は必ず に名前を変更してください。 {.example.env}{.env}

ステップ2 – .envファイルにカスタム値を入力する

デフォルトの環境変数内容

# You can find documentation for all the supported env variables at https://docs.immich.app/install/environment-variables

# The location where your uploaded files are stored
UPLOAD_LOCATION=./library

# The location where your database files are stored. Network shares are not supported for the database
DB_DATA_LOCATION=./postgres

# To set a timezone, uncomment the next line and change Etc/UTC to a TZ identifier from this list: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List
# TZ=Etc/UTC

# The Immich version to use. You can pin this to a specific version like "v2.1.0"
IMMICH_VERSION=v2

# Connection secret for postgres. You should change it to a random password
# Please use only the characters `A-Za-z0-9`, without special characters or spaces
DB_PASSWORD=postgres

# The values below this line do not need to be changed
###################################################################################
DB_USERNAME=postgres
DB_DATABASE_NAME=immich
  • バックアップ資産を保管する希望の場所を配置しましょう。サーバー上の新しいディレクトリで、十分な空き容量があるはずです。{UPLOAD_LOCATION}
  • カスタム値に変更することも検討してください。Postgresは公開されていないため、このパスワードはローカル認証にのみ使われます。Dockerの解析問題を避けるために、文字のみを使うのが最善です。これは便利なユーティリティです。{DB_PASSWORDA-Za-z0-9pwgen}
  • コメントを消してタイムゾーンを設定しましょう。{TZ=}
  • 必要に応じてカスタムデータベース情報を入力してください。

ステップ3 – コンテナを起動する

ステップ1で作成したディレクトリ(今はカスタマイズ済みのファイルとファイルが入っているはず)から、次のコマンドを実行してImmichをバックグラウンドサービスとして起動する。{docker-compose.yml}{.env}

コンテナを起動する

docker compose up -d
  • Docker バージョン

もしエラーが出るなら、おそらく間違ったDockerバージョンを使っているでしょう。(例えば、Ubuntu 22.04.3 LTSの docker.io パッケージでこの現象が起こります。)問題を解決するには、ディストリビューションの完全なDocker Engineインストール手順、特に「古いバージョンをアンインストールする」と「apt/rpmリポジトリを使ってインストールする」セクションを踏む必要があります。これらはディストリビューションのDockerパッケージを公式のDockerパッケージに置き換えます。unknown shorthand flag: 'd' in -dopen <location of your .env file>: permission denied

正しい命令は実際には ではなく であることに注意してください。後者をバニラのUbuntu 22.04で試すと、別の方法で失敗します:docker composedocker-compose

The Compose file './docker-compose.yml' is invalid because:
'name' does not match any of the regexes: '^x-'

公式Dockerリポジトリからのインストールについては前の段落を参照してください。

  • ヘルスチェック開始間隔

エラーが出た場合は、ファイルのセクションで の行をコメントアウトすると役立ちます。{can't set healthcheck.start_interval as feature require Docker Engine v25 or later}{start_interval}{database}{docker-compose.yml}

次のステップ

インストール後の手順とアップグレードの手順を読んでください。

Last updated on  by github-actions

コメント