Hue in Docker

Published on 12 March 2019 in - 2 minutes read - Last modified on 05 June 2023

Note: This post has been replaced by a more recent How-to

Containers offer a modern way to isolate and run applications. This post is the first one of a series showing how to run Hue as a service. Here, we will explore how to build, run and configure a Hue server image with Docker.

For impatient people, the source is available at tools/docker.

Get the docker image

Just pull the latest from the Internet or build it yourself from the Hue repository.

Pull the image from Hue's Docker Hub:

sudo docker pull gethue/hue:latest

Build the image

Directly from Github source:

sudo docker build -t hue -f tools/docker/hue/Dockerfile

Or from a cloned local Hue:

sudo docker build . -t hue -f tools/docker/hue/Dockerfile


  • Feel free to replace -t hue in all the commands by your own docker repository and image tag, e.g. gethue/hue:latest
  • Tag and push the image to the container registry
docker build . -t

docker push

Run the image

Directly boot the image:

docker run -it -p 8888:8888 gethue/hue:latest

Hue should then be up and running on your default Docker IP on the port 8888, so usually


By default the Hue container is using a default configuration that assumes localhost for all the data services and is backed by a SQLite database in the container (and so everything is reseted at each restart and Hue can't interact with any service).

  • The default ini is used for configuration at the image build time (e.g. which apps to always disable or certain settings like banner customization)
  • In order to configure Hue at the image runtime and for example point to external services, use the simplified hue.ini, edit the values before pointing to it and starting via:
docker run -it -p 8888:8888 -v $PWD/tools/docker/hue/hue.ini:/usr/share/hue/desktop/conf/z-hue.ini gethue/hue

and for advanced properties copy the full configuration ini:

cp /desktop/conf.dist/hue.ini .
docker run -it -p 8888:8888 -v $PWD/hue.ini:/usr/share/hue/desktop/conf/z-hue.ini gethue/hue


You can read more about configuring Hue in the documentation.


In the next episode, we will see for running this Hue container in Kubernetes!


As usual feel free to send feedback to the hue-user list or @gethue or send improvements!

comments powered by Disqus

More recent stories

03 May 2023
Discover the power of Apache Ozone using the Hue File Browser
Read More
23 January 2023
Hue 4.11 and its new dialects and features are out!
Read More