Keep Your Immich Server Up-to-Date 🚀

OmkarBhede — Fri, 26 Sep 2025 07:51:38 +0000

Running your own Immich server is awesome, but keeping it updated can be a tiny hassle. Here’s a simple Bash script that checks your current version, compares it with the latest GitHub release, and even helps you update safely.

How it Works:

Check Current Version – Pulls your running Immich version via API.
Check Latest Release – Fetches the latest release from GitHub.
Compare Versions – Detects major, minor, or patch updates.
Update Easily – Prompts you to update, then pulls the new Docker image and restarts the server.

How to find api token?
go to settings > API keys > New API key [only server permission is required]

💡 Community tip: You can even run this on a cron job to get regular reminders about updates.

#!/bin/bash
set -e

# -------------------------------
# Configuration
# -------------------------------
IMMICH_PORT=xxxxx
IMMICH_API_KEY="xxxxx"

# -------------------------------
# Function to get current Immich version
# -------------------------------
get_current_version() {
  RESPONSE=$(curl -s -H "x-immich-api-key: $IMMICH_API_KEY" \
      http://localhost:$IMMICH_PORT/api/server/version)

  # Extract version from major.minor.patch
  VERSION=$(echo "$RESPONSE" | sed -n 's/.*"major":\([0-9]*\).*"minor":\([0-9]*\).*"patch":\([0-9]*\).*/\1.\2.\3/p')

  if [[ -z "$VERSION" ]]; then
    VERSION="unknown"
  fi
  echo "$VERSION"   # NO 'v' prefix here
}

# -------------------------------
# Function to get latest release from GitHub
# -------------------------------
get_latest_version() {
  TAG=$(curl -s https://api.github.com/repos/immich-app/immich/releases/latest \
    | sed -n 's/.*"tag_name": *"\([^"]*\)".*/\1/p')

  # Strip leading 'v' if present
  echo "${TAG#v}"
}

# -------------------------------
# Compare versions
# -------------------------------
compare_versions() {
  IFS='.' read -r c_major c_minor c_patch <<< "$1"
  IFS='.' read -r l_major l_minor l_patch <<< "$2"

  if [[ "$c_major" -lt "$l_major" ]]; then
    echo "major"
  elif [[ "$c_minor" -lt "$l_minor" ]]; then
    echo "minor"
  elif [[ "$c_patch" -lt "$l_patch" ]]; then
    echo "patch"
  else
    echo "none"
  fi
}

# -------------------------------
# Main script
# -------------------------------
echo "🔍 Checking Immich versions..."

CURRENT_VERSION=$(get_current_version)
LATEST_VERSION=$(get_latest_version)

if [[ -z "$LATEST_VERSION" ]]; then
  LATEST_VERSION="unknown"
fi

echo "➡️  Current running version: v$CURRENT_VERSION"
echo "➡️  Latest available version: v$LATEST_VERSION"

if [[ "$CURRENT_VERSION" == "$LATEST_VERSION" ]] || [[ "$LATEST_VERSION" == "unknown" ]]; then
  echo "✅ No update required. You are running the latest version."
  exit 0
fi

UPDATE_TYPE=$(compare_versions "$CURRENT_VERSION" "$LATEST_VERSION")

case $UPDATE_TYPE in
  major)
    echo "⚠️  Major update available!"
    ;;
  minor)
    echo "ℹ️  Minor update available."
    ;;
  patch)
    echo "🔧 Patch update available."
    ;;
esac

read -p "Do you want to update Immich to v$LATEST_VERSION? (y/n): " confirm

if [[ "$confirm" =~ ^[Yy]$ ]]; then
  echo "🚀 Updating Immich..."
  docker compose down
  docker compose pull
  docker compose up -d
  echo "✅ Immich update complete."
else
  echo "❌ Update cancelled."
fi

Why I hate Dotenv ?

OmkarBhede — Sat, 23 Sep 2023 23:04:21 +0000

I have built FREE tool to deal with this problem. link

Hi developers 👋🏼 I have been using NodeJS for couple of years but still I feel managing environment variables, especially in production, is a daunting task.

What should I do ? Should I add env variables to docker build command ? Should I add env variables in GitHub Secrets ? OR Should I ssh into ec2 and create .env file 😓

So lets address this problem…

1. The Problem with Dotenv
Dotenv is a moat popular package used by 30M+ developers to load environment variables from a .env file into the process environment. While it simplifies the process, it has its limitations:

Lack of Security: Dotenv relies on plaintext .env files, which can expose sensitive information if not handled carefully. (like committing it to GitHub 🤯)
Limited Functionality: It doesn’t provide an solution for production environment.
Inflexible Configuration: Dotenv lacks flexibility when it comes to managing different configurations for different environments (development, staging, production).

What I dont want ?

But there will be some solution created by Big Cloud Giants ? Right ?
Yes. but…

Azure — costs 1$ per key per month with additional per api call charges

GCP — almost 0.5$ per key per month (gcp has most complicated pricing tier I have ever seen)

AWS — costs 0.8$ per key per month with additional api call charges

i.e. I need to pay at least a dollar/month to just store NODE_ENV=production 🤔

then why cant I use GitHub Secrets ? Its FREE.. is it ?
This is the best solution for managing env variables is out there. but still its free tier lacks environment specific secrets manager. (Yeah Im indie hacker and cant afford to buy $20/month Plan)

& I dont want to manage this sh*t..

Then What To Do ?

If there is no solution, then best solution is to build the solution.

What if there is npm package which —

does everything dotenv does &
in development loads from .env file
in production checks for .env files or else loads it from cloud without any major configuration
there is easy and secure way to access, modify, delete environments.
& is cheap.

So Finally what I built ?

simple nodeJS implementation. (envvaults npm package — wrapper around dotenv)
Web Dashboard to manage .envs
VS Code extension to manage .envs from VS Code (WHY NOT?)
What about security ? Okay.. Lets implement what Github Secrets is using 😘. Libsodium sealed boxes added

But how will it load .env in production ?
envvaults npm package requires 2 predefined env variables- EV_AID & EV_KEY. with these 2 env variables it will fetch all remaing variables defined inside “VAULT”.

EV_AID is account ID and EV_KEY is secret key for specific vault.

How can you use this ?
step 1. install npm package => npm i envvaults

step 2. create account on this link

step 3. access inside VS Code using this link

Done!! Now lets get back to writing code 😤

DEV Community: OmkarBhede

Keep Your Immich Server Up-to-Date 🚀

Why I hate Dotenv ?