ubuntu/squid Docker Image

ubuntu/squid is a rock for Squid maintained by https://canonical.com/.

Squid is a caching proxy for the Web supporting HTTP, HTTPS, FTP, and more. It reduces bandwidth and improves response times by caching and reusing frequently-requested web pages. Squid has extensive access controls and makes a great server accelerator. It runs on most available operating systems, including Windows and is licensed under the GNU GPL.

\http://www.squid-cache.org/\]

Tags and Architectures

NOTE: These tags follow a specific naming convention that respects the concept of channels.

View deprecated tags

Tags	Support ended on	Upgrade Path
6.13-25.04_beta	01/2026	-
6.10-24.10_beta	07/2025	-
6.1-23.10_beta	07/2024	-
5.7-23.04_beta	01/2024	-
5.6-22.10_beta	07/2023	-
4.13-21.10_beta	07/2022	-
4.13-21.04_beta	01/2022	-
4.10-20.04_beta	05/2025	-

Get started

This rock's entrypoint is Pebble, a container-optimized init process that enables the orchestration of a collection of local service processes as an organized set.

\https://documentation.ubuntu.com/pebble/\]

Inspect

To view the https://documentation.ubuntu.com/rockcraft/en/latest/reference/rockcraft-yaml/#services and https://documentation.ubuntu.com/rockcraft/latest/reference/rockcraft-yaml/#checks defined in this rock:

sh
docker run --rm ubuntu/squid:6.13-25.04_beta plan

Run

To run this rock, use any of the usual container runtimes, for example, docker:

sh
docker run --name squid-container \
    -p 3128:3128 \
    ubuntu/squid:6.13-25.04_beta

Access the Squid proxy at localhost:3128.

Get logs

To view the logs of the running container, run:

sh
docker exec squid-container pebble logs

Or, for a specific service:

sh
docker exec squid-container pebble logs <service>

Monitor health checks

Rocks may have predefined health checks that you can list by running:

sh
docker exec squid-container pebble checks

The overall health of your container can be inspected via:

sh
docker exec squid-container pebble health

Deploy with Kubernetes

Works with any Kubernetes; if you don't have one, we recommend you https://microk8s.io/. Then, run microk8s.enable dns storage and snap alias microk8s.kubectl kubectl.

Download https://git.launchpad.net/~ubuntu-docker-images/ubuntu-docker-images/+git/squid/plain/examples/config/squid.conf?h=6.1-23.10 and https://git.launchpad.net/~ubuntu-docker-images/ubuntu-docker-images/+git/squid/plain/examples/squid-deployment.yml?h=6.1-23.10 and set containers.squid.image in squid-deployment.yml to your chosen channel tag (e.g. ubuntu/squid:6.13-25.04_beta), then:

sh
kubectl create configmap squid-config --from-file=squid-config=squid.conf
kubectl apply -f squid-deployment.yml

Access the Squid proxy on port 3128.

Configuration

Environment variables

Volumes

Ports

---

\https://github.com/canonical/squid-rock/issues\] \https://github.com/canonical/squid-rock\]

Canonical is the provider of this container image. It is the user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within, as well as with https://canonical.com/legal/intellectual-property-policy.