Update March 2019: this post was refresh in Hue in Docker
The current way to play with Hue is often to go on demo.gethue.com 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!
Please find below a video showing how to start Hue with Docker on a Mac and instructions for Linux users.
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 0.0.0.0:8888
Hue should then be up and running on your default Docker IP on the port 8888, so usually http://192.168.99.100:8888.
Note If 192.168.99.100 does not work, get the IP of the docker container with:
sudo docker ps CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES b7950388c1db gethue/hue:latest "bash" 10 minutes ago Up 10 minutes 22/tcp, 0.0.0.0:8888->8888/tcp agitated_mccarthy
inet addr, so in our case http://172.17.0.1:8888:
sudo docker exec -it b7950388c1db /sbin/ifconfig eth0 eth0 Link encap:Ethernet HWaddr 02:42:ac:11:00:01 inet addr:172.17.0.1 Bcast:0.0.0.0 Mask:255.255.0.0 inet6 addr: fe80::42:acff:fe11:1/64 Scope:Link UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 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)
You can then configure Hue and start using it!
Read more about how to configure Hue. The development version uses the configuration file