Utility Container: Prowlarr

A lightweight Alpine-based container for Prowlarr, an indexer manager for *arr applications.

Attribution

Note: These containers are no longer supported by the original author, onedr0p, but were originally from https://github.com/home-operations/containers. This repository maintains and extends the original work with additional features and updates.

Overview

This container provides Prowlarr with a minimal footprint, including essential utilities for production deployments. Built on Alpine Linux 3.22 with multi-architecture support (amd64/arm64).

Features

• ✅ Multi-architecture support (AMD64 & ARM64)
• ✅ Minimal Alpine-based image
• ✅ Security scanning with Trivy
• ✅ Automated code formatting (shfmt)
• ✅ Shell script validation (ShellCheck)
• ✅ Dockerfile linting (Hadolint)
• ✅ Container signing with Cosign
• ✅ SBOM generation with Syft
• ✅ CI/CD pipeline with Woodpecker

Usage

Docker Compose

version: '3.8'
services:
  prowlarr:
    image: ${CI_FORGE_URL}/${CI_REPO,,}:latest
    container_name: prowlarr
    restart: unless-stopped
    volumes:
      - ./config:/config
    environment:
      - TZ=America/New_York
      - PROWLARR__UPDATE__BRANCH=develop
    ports:
      - "9696:9696"

Docker Run

docker run -d \
  --name prowlarr \
  -p 9696:9696 \
  -v /path/to/config:/config \
  -e TZ=America/New_York \
  ${CI_FORGE_URL}/${CI_REPO,,}:latest

Configuration

Environment Variables

Variable	Default	Description
TZ	Etc/UTC	Timezone
PROWLARR__UPDATE__BRANCH	develop	Prowlarr update branch
UMASK	0002	File permissions mask

Volumes

• /config - Prowlarr configuration and data directory

Build

Local Build

docker build -t prowlarr:latest .

Multi-Platform Build

docker buildx build \
  --platform linux/amd64,linux/arm64 \
  -t prowlarr:latest \
  --push .

Development

This project uses a comprehensive CI/CD pipeline with Woodpecker:

• Code Quality: shfmt formatting, ShellCheck validation, Hadolint linting
• Security: Trivy vulnerability scanning
• Build: Multi-architecture container builds
• Distribution: Automated pushing to container registry
• Verification: Container signing and SBOM generation

Running Tests

# Format shell scripts
shfmt -w .

# Check shell scripts
shellcheck entrypoint.sh

# Lint Dockerfile
hadolint Dockerfile

# Security scan
trivy fs . --severity CRITICAL

Version Information

• Prowlarr Version: 1.32.2.4987 (automatically updated via Renovate)
• Base Image: Alpine 3.22
• Vendor: Solace System

Support

• Prowlarr Documentation
• Docker Hub
• GitHub Issues

License

This project is released under the MIT License. See LICENSE.md for details. This does not cover any packaged applications, which are included unmodified and are subject to their own licenses.

---

Note: This is a utility container maintained by Solace System. For official Prowlarr support, please refer to the Prowlarr project.