This repository provides Docker images for Privoxy, a non-caching web proxy with advanced filtering capabilities. Two image variants are available:

• lusky3/privoxy:latest and lusky3/privoxy:<version> (e.g., 4.1.0): Built from stable releases on SourceForge.
• lusky3/privoxy:nightly: Built daily from the latest commit in the Privoxy Git repository.

Images are available on both DockerHub and GitHub Container Registry.

• Multi-architecture support: linux/amd64 and linux/arm64.
• Built from source for both stable and nightly variants.
• Lightweight Alpine Linux base image.
• Docker healthcheck.
• Automated updates and builds via GitHub Actions.

• Stable (latest release):

  docker pull lusky3/privoxy:latest

• Specific stable version (e.g., 4.1.0):

  docker pull lusky3/privoxy:4.1.0

• Nightly (latest Git commit):

  docker pull lusky3/privoxy:nightly

Run Privoxy on port 8118 (default):

docker run -d -p 8118:8118 lusky3/privoxy:latest

To use a custom config file:

docker run -d -p 8118:8118 -v /path/to/your/config:/etc/privoxy/config lusky3/privoxy:latest

Test the proxy with curl:

curl -x http://localhost:8118 http://example.com

• lusky3/privoxy:latest: Latest stable release (e.g., 4.1.0 as of February 2026).
• lusky3/privoxy:<version>: Specific stable versions (e.g., 4.1.0).
• lusky3/privoxy:nightly: Latest Git commit, rebuilt daily.
• lusky3/privoxy:<sha>: Git SHA tags for both stable and nightly builds.

The same tags are available on GitHub Container Registry (e.g., ghcr.io/lusky3/privoxy-docker:4.1.0).

• Stable Builds:

  • Source: SourceForge stable releases.
  • Trigger: On push to main or manual dispatch.
  • Update Check: Weekly (Sundays at 2 AM UTC) via GitHub Actions, updating to the latest stable version.
  • Workflow: .github/workflows/build-stable.yml.

• Nightly Builds:

  • Source: Privoxy Git repository (snapshot tarball).
  • Trigger: Daily at midnight UTC or manual dispatch.
  • Workflow: .github/workflows/build-nightly.yml.

The Dockerfile supports both sources using build arguments (BUILD_SOURCE and PRIVOXY_VERSION).

To build locally:

• Stable (e.g., 4.1.0):

  docker build -t privoxy:4.1.0 --build-arg BUILD_SOURCE=sourceforge --build-arg PRIVOXY_VERSION=4.1.0 .

• Nightly:

  docker build -t privoxy:nightly --build-arg BUILD_SOURCE=git .

The default config file (config.conf) is minimal. Mount your own config to /etc/privoxy/config for custom settings. See the Privoxy documentation for configuration options.

The container includes a healthcheck:

• Endpoint: http://detectportal.firefox.com/success.txt
• Interval: 30 seconds
• Timeout: 3 seconds

If the proxy fails to respond, the container is marked unhealthy.

• Contributions welcome!
• Fork the repository.
• Submit pull requests to main.

This project is licensed under the MIT License. Privoxy itself is licensed under the GNU General Public License v2 (GPLv2). See the Privoxy license for details.