Getting started with Hue in 2 minutes with Docker

Published on 18 December 2015 in - 2 minutes read - Last modified on 06 March 2021

Update March 2019: this post was refresh in Hue in Docker


The current way to play with Hue is often to go on or download a Virtual Machine. However, these have some limitations. Using Docker instead provides a much better experience as it:

  • is lighter and more robust than a VM
  • gives admin permissions
  • has much faster execution

Docker makes it perfect for quick starting on Hue development or pointing Hue to your current cluster and giving it a try. This is for this that we now provide a Docker image of Hue!

Hue Running in Kitematic


Please find below a video showing how to start Hue with Docker on a Mac and instructions for Linux users.


DockerPulls DockerStars

Get the docker image

They are two ways: just pull the latest from the Internet or build it yourself from the Hue repository.

Pull the image from Docker Hub

sudo docker pull gethue/hue:latest

Build the image

cd tools/docker/hue-base

sudo docker build -rm -t gethue/hue:latest .

Running the image

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

This opens a bash to the root of the project. From there you can run the development version of Hue with the command

./build/env/bin/hue runserver_plus

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

Note If does not work, get the IP of the docker container with:

sudo docker ps


b7950388c1db gethue/hue:latest "bash" 10 minutes ago Up 10 minutes 22/tcp,>8888/tcp agitated_mccarthy

Then get inet addr, so in our case

sudo docker exec -it b7950388c1db /sbin/ifconfig eth0

eth0 Link encap:Ethernet HWaddr 02:42:ac:11:00:01

inet addr: Bcast: Mask:

inet6 addr: fe80::42:acff:fe11:1/64 Scope:Link


RX packets:67 errors:0 dropped:0 overruns:0 frame:0

TX packets:8 errors:0 dropped:0 overruns:0 carrier:0

collisions:0 txqueuelen:0

RX bytes:10626 (10.6 KB) TX bytes:648 (648.0 B)

alt text


You can then configure Hue and start using it!

Read more about how to configure Hue. The development version uses the configuration file desktop/conf/pseudo-distributed.ini.

comments powered by Disqus

More recent stories

26 June 2024
Integrating Trino Editor in Hue: Supporting Data Mesh and SQL Federation
Read More
03 May 2023
Discover the power of Apache Ozone using the Hue File Browser
Read More