ubuntu/nginx repository overview

ubuntu/nginx is a rock for Nginx maintained by Canonical⁠.

Nginx is a high-performance web and reverse proxy server created by Igor Sysoev. It can be used both as a standalone web server and as a proxy to reduce the load on back-end HTTP or mail servers. Read more on the nginx website⁠.

[Learn more about Nginx⁠]

⁠Tags and Architectures

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

⁠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.

[Learn more about Pebble⁠]

⁠Inspect

To view the Pebble services⁠ and checks⁠ defined in this rock:

docker run --rm ubuntu/nginx:1.26-25.04_beta plan

⁠Run

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

docker run --name nginx-container \
 -p 8080:80 \
 ubuntu/nginx:1.26-25.04_beta

Nginx starts and serves content on port 80. Access your Nginx server at http://localhost:8080⁠.

⁠Get logs

To view the logs of the running container, run:

docker exec nginx-container pebble logs

Or, for a specific service:

docker exec nginx-container pebble logs <service>

⁠Monitor health checks

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

docker exec nginx-container pebble checks

The overall health of your container can be inspected via:

docker exec nginx-container pebble health

⁠Deploy with Kubernetes

Works with any Kubernetes; if you don't have one, we recommend you install MicroK8s⁠. Then, run microk8s.enable dns storage and snap alias microk8s.kubectl kubectl.

Download nginx.conf⁠, index.html⁠ and nginx-deployment.yml⁠ and set containers.nginx.image in nginx-deployment.yml to your chosen channel tag (e.g. ubuntu/nginx:1.26-25.04_beta), then:

kubectl create configmap nginx-config --from-file=nginx=nginx.conf --from-file=nginx-site=index.html
kubectl apply -f nginx-deployment.yml

You will now be able to connect to the nginx server on http://localhost:31080.

⁠Configuration

⁠Environment variables

⁠Volumes

⁠Ports

[Report a bug⁠] [Contribute⁠]

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 Canonical’s IP Policy⁠.