pacnpal/simpleguardhome repository overview

⁠SimpleGuardHome Docker Image

A Docker image for SimpleGuardHome, a tool for managing AdGuard Home instances.

⁠Quick Start

docker run -d \
  --name simpleguardhome \
  -p 8000:8000 \
  -e ADGUARD_HOST=http://adguardhome.url
  -e ADGUARD_PORT=3000
  -e ADGUARD_USERNAME=username
  -e ADGUARD_PASSWORD=password
  -v /host/config:/app/rules_backup \
  pacnpal/simpleguardhome:latest

⁠Tags

• latest: Latest stable release
• main: Latest build from main branch
• x.y.z: Semantic version releases
• sha-xxxxx: Specific commit builds

⁠Supported Architectures

• amd64
• arm64

⁠Environment Variables

From .env.example:

ADGUARD_HOST=http://localhost⁠ # AdGuard Home host URL

ADGUARD_PORT=3000 # AdGuard Home API port

ADGUARD_USERNAME=admin # Required: AdGuard Home username

ADGUARD_PASSWORD=password # Required: AdGuard Home password

⁠Build Information

• Built automatically via GitHub Actions
• Base image: Python official image
• Dependencies installed from requirements.txt
• Source code from main repository branch

⁠Security

• Runs as non-root user
• Multi-stage build to minimize image size
• Dependencies pinned to specific versions

⁠Maintainers

Maintained by the SimpleGuardHome team through GitHub Actions automation.

⁠Source Code

Available on GitHub at https://github.com/pacnpal/simpleguardhome⁠