devilbox/varnish repository overview
Docker Varnish
Varnish Docker images for the Devilbox.
| Docker Hub | Upstream Project |
|---|---|
 |  |
Documentation
In case you seek help, go and visit the community pages.
Documentation | Chat | Forum |
|---|---|---|
|
|
|
| devilbox.readthedocs.io | gitter.im/devilbox | devilbox.discourse.group |
Build
# Build Varnish 4
make build-4
# Build Varnish 5
make build-5
# Build Varnish 6
make build-6
Environment variables
| Variable | Default value | Description |
|---|---|---|
| VARNISH_CONFIG | /etc/varnish/default.vcl | Path to Varnish configuration file |
| CACHE_SIZE | 128m | Varnish Cache size |
| VARNISHD_PARAMS | -p default_ttl=3600 -p default_grace=3600 | Additional Varnish startup parameter |
| BACKEND_HOST | localhost | IP or hostname of backend server. Important: This variable only has effect when using the bundled config. If you change VARNISH_CONFIG you need to hard-code it in your custom configuration. |
| BACKEND_PORT | 80 | Port of backend server. Important: This variable only has effect when using the bundled config. If you change VARNISH_CONFIG you need to hard-code it in your custom configuration. |
Mount points
| Container path | Description |
|---|---|
| /etc/varnish.d/ | Mount your host directory with *.vcl files to this directory when you want to override the varnish config |
Ports
By default each Varnish version exposes 6081 as its default listening port.
Default configuration
Credits for default.vcl configuration goes here:
Available Docker images
| Docker image | Varnish version |
|---|---|
devilbox/varnish:latest | Varnish 6 |
devilbox/varnish:6 | Varnish 6 |
devilbox/varnish:5 | Varnish 5 |
devilbox/varnish:4 | Varnish 4 |
Examples
Use bundled config
Serve Varnish on port 80, use bundled config and forward Varnish requests to a webserver on
192.168.0.1 on port 8080 (which accepts HTTP and not HTTPS):
docker run -it -d --rm \
-e BACKEND_HOST=192.168.0.1 \
-e BACKEND_PORT=8080 \
-p "80:6081" \
devilbox/varnish:6
Use custom config
Important:
When using a custom config, the BACKEND_HOST and BACKEND_PORT variables will have no effect
and you need to ensure to hard-code this in your custom config.
Serve Varnish on port 80, use custom config on host system (/home/users/varnish/my-varnish.vcl)
and forward Varnish requests to a webserver on 192.168.0.1 on port 8080 (which accepts HTTP and not HTTPS).
docker run -it -d --rm \
-e BACKEND_HOST=192.168.0.1 \
-e BACKEND_PORT=8080 \
-e VARNISH_CONFIG=/etc/varnish.d/my-varnish.vcl \
-v "/home/users/varnish/:/etc/varnish.d/" \
-p "80:6081" \
devilbox/varnish:6
LICENSE
Copyright (c) 2019 cytopia
Tag summary
Content type
Image
Digest
Size
68.1 MB
Last updated
over 5 years ago
docker pull devilbox/varnish