Public | Automated Build

Last pushed: 9 months ago
Short Description
An Alpine Linux base image, featuring s6 and Consul service discovery and registration.
Full Description


A Docker image designed for extending from when you need to run Consul, based on Alpine Linux.
This image belongs to a suite of images documented here.

This image is designed to be extended from, with specific services added to it via Consul, along with appropriate health checks.

Image size is ~49.4 MB.


This image features:


See for image contents.


To use this image include FROM smebberson/alpine-consul-base at the top of your Dockerfile, or simply docker run --name consul-base smebberson/alpine-consul-base.

This container has been setup to automatically connect to a Consul cluster, created with a service name of consul. Read more about it here.

consul-template is automatically started if templates are available.


To use consul-template:

  1. Add your templates to root/etc/consul-template/templates/my-service/.
  2. Make consul-template configuration aware of your templates by adding a configuration file in root/etc/consul-template/conf.d/my-service (use sub folders to make VOLUME /etc/consul-template/templates/my-service possible).
  3. In your Dockerfile be sure to run mkfifo /etc/services.d/my-service/supervise/control and chmod g+w /etc/services.d/my-service/supervise/control in order to make it possible for consul-template to restart the service if needed.


An example of using this image can be found in examples/user-consul-nginx-nodejs.

Docker Pull Command
Source Repository