Enhancement: Allow setting both Celery and UWSGI nice levels. Default nice levels are UWSGI=0, Celery=5. Added documentation to the compose files on how to use it. Using nice levels for UWSGI allows us to have streaming run at a high priority.

docker/docker-compose.aio.yml

@@ -14,6 +14,15 @@ services:
       - REDIS_HOST=localhost
       - CELERY_BROKER_URL=redis://localhost:6379/0
       - DISPATCHARR_LOG_LEVEL=info
+      # Process Priority Configuration (Optional)
+      # Lower values = higher priority. Range: -20 (highest) to 19 (lowest)
+      # Negative values require cap_add: SYS_NICE (uncomment below)
+      #- UWSGI_NICE_LEVEL=-5   # uWSGI/FFmpeg/Streaming (default: 0, recommended: -5 for high priority)
+      #- CELERY_NICE_LEVEL=5   # Celery/EPG/Background tasks (default: 5, low priority)
+    #
+    # Uncomment to enable high priority for streaming (required if UWSGI_NICE_LEVEL < 0)
+    #cap_add:
+    #  - SYS_NICE
     # Optional for hardware acceleration
     #devices:
     #  - /dev/dri:/dev/dri  # For Intel/AMD GPU acceleration (VA-API)

docker/docker-compose.debug.yml

@@ -18,3 +18,12 @@ services:
       - REDIS_HOST=localhost
       - CELERY_BROKER_URL=redis://localhost:6379/0
       - DISPATCHARR_LOG_LEVEL=trace
+      # Process Priority Configuration (Optional)
+      # Lower values = higher priority. Range: -20 (highest) to 19 (lowest)
+      # Negative values require cap_add: SYS_NICE (uncomment below)
+      #- UWSGI_NICE_LEVEL=-5   # uWSGI/FFmpeg/Streaming (default: 0, recommended: -5 for high priority)
+      #- CELERY_NICE_LEVEL=5   # Celery/EPG/Background tasks (default: 5, low priority)
+    #
+    # Uncomment to enable high priority for streaming (required if UWSGI_NICE_LEVEL < 0)
+    #cap_add:
+    #  - SYS_NICE

docker/docker-compose.dev.yml

@@ -17,6 +17,15 @@ services:
       - REDIS_HOST=localhost
       - CELERY_BROKER_URL=redis://localhost:6379/0
       - DISPATCHARR_LOG_LEVEL=debug
+      # Process Priority Configuration (Optional)
+      # Lower values = higher priority. Range: -20 (highest) to 19 (lowest)
+      # Negative values require cap_add: SYS_NICE (uncomment below)
+      #- UWSGI_NICE_LEVEL=-5   # uWSGI/FFmpeg/Streaming (default: 0, recommended: -5 for high priority)
+      #- CELERY_NICE_LEVEL=5   # Celery/EPG/Background tasks (default: 5, low priority)
+    #
+    # Uncomment to enable high priority for streaming (required if UWSGI_NICE_LEVEL < 0)
+    #cap_add:
+    #  - SYS_NICE
 
   pgadmin:
     image: dpage/pgadmin4

docker/docker-compose.yml

@@ -17,6 +17,15 @@ services:
       - REDIS_HOST=redis
       - CELERY_BROKER_URL=redis://redis:6379/0
       - DISPATCHARR_LOG_LEVEL=info
+      # Process Priority Configuration (Optional)
+      # Lower values = higher priority. Range: -20 (highest) to 19 (lowest)
+      # Negative values require cap_add: SYS_NICE (uncomment below)
+      #- UWSGI_NICE_LEVEL=-5   # uWSGI/FFmpeg/Streaming (default: 0, recommended: -5 for high priority)
+      #- CELERY_NICE_LEVEL=5   # Celery/EPG/Background tasks (default: 5, low priority)
+    #
+    # Uncomment to enable high priority for streaming (required if UWSGI_NICE_LEVEL < 0)
+    #cap_add:
+    #  - SYS_NICE
     # Optional for hardware acceleration
     #group_add:
     #  - video

docker/entrypoint.sh

@@ -40,6 +40,18 @@ export REDIS_DB=${REDIS_DB:-0}
 export DISPATCHARR_PORT=${DISPATCHARR_PORT:-9191}
 export LIBVA_DRIVERS_PATH='/usr/local/lib/x86_64-linux-gnu/dri'
 export LD_LIBRARY_PATH='/usr/local/lib'
+
+# Process priority configuration
+# UWSGI_NICE_LEVEL: Absolute nice value for uWSGI/streaming (default: 0 = normal priority)
+# CELERY_NICE_LEVEL: Absolute nice value for Celery/background tasks (default: 5 = low priority)
+# Note: The script will automatically calculate the relative offset for Celery since it's spawned by uWSGI
+export UWSGI_NICE_LEVEL=${UWSGI_NICE_LEVEL:-0}
+CELERY_NICE_ABSOLUTE=${CELERY_NICE_LEVEL:-5}
+
+# Calculate relative nice value for Celery (since nice is relative to parent process)
+# Celery is spawned by uWSGI, so we need to add the offset to reach the desired absolute value
+export CELERY_NICE_LEVEL=$((CELERY_NICE_ABSOLUTE - UWSGI_NICE_LEVEL))
+
 # Set LIBVA_DRIVER_NAME if user has specified it
 if [ -v LIBVA_DRIVER_NAME ]; then
     export LIBVA_DRIVER_NAME
@@ -78,6 +90,7 @@ if [[ ! -f /etc/profile.d/dispatcharr.sh ]]; then
         DISPATCHARR_ENV DISPATCHARR_DEBUG DISPATCHARR_LOG_LEVEL
         REDIS_HOST REDIS_DB POSTGRES_DIR DISPATCHARR_PORT
         DISPATCHARR_VERSION DISPATCHARR_TIMESTAMP LIBVA_DRIVERS_PATH LIBVA_DRIVER_NAME LD_LIBRARY_PATH
+        CELERY_NICE_LEVEL UWSGI_NICE_LEVEL
     )
 
     # Process each variable for both profile.d and environment
@@ -170,10 +183,13 @@ if [ "$DISPATCHARR_DEBUG" != "true" ]; then
     uwsgi_args+=" --disable-logging"
 fi
 
-# Launch uwsgi -p passes environment variables to the process
-su -p - $POSTGRES_USER -c "cd /app && uwsgi $uwsgi_args &"
-uwsgi_pid=$(pgrep uwsgi | sort | head -n1)
-echo "✅ uwsgi started with PID $uwsgi_pid"
+# Launch uwsgi with configurable nice level (default: -10 for high priority)
+# Users can override via UWSGI_NICE_LEVEL environment variable in docker-compose
+# Start with nice as root, then use setpriv to drop privileges to dispatch user
+# This preserves both the nice value and environment variables
+cd /app && nice -n $UWSGI_NICE_LEVEL setpriv --reuid=$POSTGRES_USER --regid=$POSTGRES_USER --clear-groups -- uwsgi $uwsgi_args &
+uwsgi_pid=$!
+echo "✅ uwsgi started with PID $uwsgi_pid (nice $UWSGI_NICE_LEVEL)"
 pids+=("$uwsgi_pid")
 
 # sed -i 's/protected-mode yes/protected-mode no/g' /etc/redis/redis.conf
@@ -218,7 +234,7 @@ echo "🔍 Running hardware acceleration check..."
 
 # Wait for at least one process to exit and log the process that exited first
 if [ ${#pids[@]} -gt 0 ]; then
-    echo "⏳ Waiting for processes to exit..."
+    echo "⏳ Dispatcharr is running. Monitoring processes..."
     while kill -0 "${pids[@]}" 2>/dev/null; do
         sleep 1  # Wait for a second before checking again
     done

docker/uwsgi.debug.ini

@@ -7,9 +7,10 @@ exec-before = python /app/scripts/wait_for_redis.py
 
 ; Start Redis first
 attach-daemon = redis-server
-; Then start other services
-attach-daemon = nice -n 5 celery -A dispatcharr worker --autoscale=6,1
-attach-daemon = nice -n 5 celery -A dispatcharr beat
+; Then start other services with configurable nice level (default: 5 for low priority)
+; Users can override via CELERY_NICE_LEVEL environment variable in docker-compose
+attach-daemon = nice -n $(CELERY_NICE_LEVEL) celery -A dispatcharr worker --autoscale=6,1
+attach-daemon = nice -n $(CELERY_NICE_LEVEL) celery -A dispatcharr beat
 attach-daemon = daphne -b 0.0.0.0 -p 8001 dispatcharr.asgi:application
 attach-daemon = cd /app/frontend && npm run dev
 

docker/uwsgi.dev.ini

@@ -9,9 +9,10 @@ exec-pre = python /app/scripts/wait_for_redis.py
 
 ; Start Redis first
 attach-daemon = redis-server
-; Then start other services
-attach-daemon = nice -n 5 celery -A dispatcharr worker --autoscale=6,1
-attach-daemon = nice -n 5 celery -A dispatcharr beat
+; Then start other services with configurable nice level (default: 5 for low priority)
+; Users can override via CELERY_NICE_LEVEL environment variable in docker-compose
+attach-daemon = nice -n $(CELERY_NICE_LEVEL) celery -A dispatcharr worker --autoscale=6,1
+attach-daemon = nice -n $(CELERY_NICE_LEVEL) celery -A dispatcharr beat
 attach-daemon = daphne -b 0.0.0.0 -p 8001 dispatcharr.asgi:application
 attach-daemon = cd /app/frontend && npm run dev
 

docker/uwsgi.ini

@@ -9,9 +9,10 @@ exec-pre = python /app/scripts/wait_for_redis.py
 
 ; Start Redis first
 attach-daemon = redis-server
-; Then start other services
-attach-daemon = nice -n 5 celery -A dispatcharr worker --autoscale=6,1
-attach-daemon = nice -n 5 celery -A dispatcharr beat
+; Then start other services with configurable nice level (default: 5 for low priority)
+; Users can override via CELERY_NICE_LEVEL environment variable in docker-compose
+attach-daemon = nice -n $(CELERY_NICE_LEVEL) celery -A dispatcharr worker --autoscale=6,1
+attach-daemon = nice -n $(CELERY_NICE_LEVEL) celery -A dispatcharr beat
 attach-daemon = daphne -b 0.0.0.0 -p 8001 dispatcharr.asgi:application
 
 # Core settings