Merge pull request #962 from karrioapi/patch-2026.1.8

Patch 2026.1.8

Author: danh91

CHANGELOG.md

@@ -1,3 +1,14 @@
+# Karrio 2026.1.8
+
+## Changes
+
+### Fix
+
+- fix: migrate to django-health-check v4.0
+- fix: ensure background tasks execute when no async worker is available
+
+---
+
 # Karrio 2026.1.7
 
 ## Changes

apps/api/karrio/server/VERSION

@@ -1 +1 @@
-2026.1.7
+2026.1.8

apps/api/karrio/server/settings/apm.py

@@ -15,13 +15,13 @@
         PostHogIntegration = None
 
 
-# Health check apps settings
-HEALTH_CHECK_APPS = [
-    "health_check",
-    "health_check.db",
-    "health_check.cache",
-    "health_check.contrib.migrations",
-    "health_check.contrib.psutil",
+# Health check settings (django-health-check v4)
+HEALTH_CHECK_APPS = ["health_check"]
+HEALTH_CHECK_CHECKS = [
+    "health_check.Database",
+    "health_check.Cache",
+    "health_check.contrib.psutil.Disk",
+    "health_check.contrib.psutil.Memory",
 ]
 INSTALLED_APPS += HEALTH_CHECK_APPS
 

apps/api/karrio/server/settings/cache.py

@@ -3,7 +3,7 @@
 import socket
 from decouple import config
 from karrio.server.settings.base import *
-from karrio.server.settings.apm import HEALTH_CHECK_APPS
+from karrio.server.settings.apm import HEALTH_CHECK_APPS, HEALTH_CHECK_CHECKS
 from karrio.server.core.logging import logger
 
 
@@ -97,12 +97,15 @@
     # Cache constance values to avoid N+1 queries on each config access
     CONSTANCE_DATABASE_CACHE_BACKEND = "default"
 
-    # Django cache health check uses the cache backend directly
-    # Only add Redis health check if REDIS_URL environment variable is set
-    # When using granular params, the cache check is sufficient
+    # Add Redis health check (v4: requires explicit async client instance)
+    # Only add if REDIS_URL is set; when using granular params, the cache check is sufficient
     if config("REDIS_URL", default=None) is not None:
-        HEALTH_CHECK_APPS += ["health_check.contrib.redis"]
-        INSTALLED_APPS += ["health_check.contrib.redis"]
+        import redis.asyncio as aioredis
+
+        _redis_check_client = aioredis.Redis.from_url(REDIS_CONNECTION_URL)
+        HEALTH_CHECK_CHECKS.append(
+            ("health_check.contrib.redis.Redis", {"client": _redis_check_client})
+        )
 
     print(f"Redis cache connection initialized")
 elif SKIP_DEFAULT_CACHE:

apps/api/karrio/server/settings/workers.py

@@ -137,3 +137,9 @@
         fsync=False,  # Disable forced fsync for better performance (default: False)
         **({"immediate": WORKER_IMMEDIATE_MODE} if WORKER_IMMEDIATE_MODE else {}),
     )
+
+    # When DETACHED_WORKER is True, the entrypoint only runs Gunicorn — no worker
+    # process will ever consume from the SQLite queue. Auto-enable immediate mode
+    # so tasks execute synchronously in the web process.
+    if DETACHED_WORKER and not IS_WORKER_PROCESS and not WORKER_IMMEDIATE_MODE:
+        HUEY.immediate = True

apps/www/openapi.yml

@@ -14,7 +14,7 @@ info:
     ## Versioning
 
     When backwards-incompatible changes are made to the API, a new, dated version is released.
-    The current version is `2026.1.7`.
+    The current version is `2026.1.8`.
 
     Read our API changelog to learn more about backwards compatibility.
 
@@ -84,7 +84,7 @@ info:
     All API requests must be made over [HTTPS](http://en.wikipedia.org/wiki/HTTP_Secure).
     API requests without authentication will also fail.
   title: Karrio API
-  version: 2026.1.7
+  version: 2026.1.8
 paths:
   /:
     get:

bin/deploy-hobby

@@ -2,7 +2,7 @@
 
 set -e
 
-export KARRIO_TAG="${KARRIO_TAG:-2026.1.7}"
+export KARRIO_TAG="${KARRIO_TAG:-2026.1.8}"
 export SENTRY_DSN="${SENTRY_DSN:-'https://public@sentry.example.com/1'}"
 
 SECRET_KEY=$(head -c 28 /dev/urandom | sha224sum -b | head -c 56)
@@ -22,7 +22,7 @@ echo ""
 if ! [ -z "$1" ]; then
     export KARRIO_TAG=$1
 else
-    echo "What version of Karrio would you like to install? (We default to '2026.1.7')"
+    echo "What version of Karrio would you like to install? (We default to '2026.1.8')"
     echo "You can check out available versions here: https://hub.docker.com/r/karrio/server/tags"
     read -r KARRIO_TAG_READ
     if [ -z "$KARRIO_TAG_READ" ]; then

bin/deploy-insiders

@@ -2,7 +2,7 @@
 
 set -e
 
-export KARRIO_TAG="${KARRIO_TAG:-2026.1.7}"
+export KARRIO_TAG="${KARRIO_TAG:-2026.1.8}"
 export SENTRY_DSN="${SENTRY_DSN:-'https://public@sentry.example.com/1'}"
 
 SECRET_KEY=$(head -c 28 /dev/urandom | sha224sum -b | head -c 56)

bin/upgrade-hobby

@@ -41,7 +41,7 @@ else
 fi
 
 [[ -f ".env" ]] && export $(cat .env | xargs) || (echo "No .env file found. Please create it with SECRET_KEY and DOMAIN set." && exit 1)
-export KARRIO_TAG="${KARRIO_TAG:-2026.1.7}"
+export KARRIO_TAG="${KARRIO_TAG:-2026.1.8}"
 
 # get karrio scripts
 mkdir -p ./karrio