Public Repository

Last pushed: 2 years ago
Short Description
Single-node deployment of Cloudera's 100% open-source Hadoop platform, and Cloudera Manager
Full Description

Cloudera QuickStart Docker Image

Cloudera QuickStart VMs and this Docker image are single-node deployments of Cloudera's 100% open-source distribution including Apache Hadoop, and Cloudera Manager. They are ideal environments for learning about Hadoop, trying out new ideas, testing and demoing your application.

Introduction to Docker

Docker is different from other platforms you may have worked with, because it uses Linux containers. Most "virtual machines" work by isolating or simulating access to the host's hardware so an entire guest operating system can run on it. Linux containers, however, work by partitioning the resources of the host operating system: they have their own view of the filesystem and other resources, but they are running on the same kernel. This is similar to BSD jails or Solaris zones. Docker provides tooling, a packaging format, and infrastructure around Linux containers and related technologies.

Docker is well supported in several recent Linux distributions. For instance, on Ubuntu 14.04, it can be installed as follows:

sudo apt-get install

Importing the Cloudera QuickStart Image

You can import the Cloudera QuickStart image from Docker Hub:

docker pull cloudera/quickstart:latest

Running a Cloudera QuickStart Container

To run a container using the image, you must know the name or hash of the image. If you followed the Importing instructions above, the name could be cloudera/quickstart:latest (or something else if you have multiple versions downloaded). The hash is also printed in the terminal when you import, or you can look up the hashes of all imported images with:

docker images

Once you know the name or hash of the image, you can run it:

docker run --hostname=quickstart.cloudera --privileged=true -t -i [OPTIONS] [IMAGE] /usr/bin/docker-quickstart

Explanation for required flags and other options are in the following table:

--hostname=quickstart.cloudera    Required: pseudo-distributed configuration assumes this hostname
--privileged=true                 Required: for HBase, MySQL-backed Hive metastore, Hue, Oozie, Sentry, and Cloudera Manager, and possibly others
-t                                Required: once services are started, a Bash shell takes over and will die without this
-i                                Required: if you want to use the terminal, either immediately or attach later
-p 8888                           Recommended: maps the Hue port in the guest to another port on the host
-p [PORT]                         Optional: map any other ports (e.g. 7180 for Cloudera Manager, 80 for a guided tutorial)
-d                                Optional: runs the container in the background

/usr/bin/docker-quickstart is provided as a convenience to start all CDH services, then run a Bash shell. You can directly run /bin/bash instead if you wish to start services manually.

See "Networking" for details about port mapping.

Connecting To The Shell

If you do not pass the -d flag to docker run, your terminal will automatically attach to that of the container.

A container will die when you exit the shell, but you can disconnect and leave the container running by hitting Ctrl+P -> Ctrl+Q.

If you have disconnected from the shell or did pass the -d flag, you can connect to the shell later with:

docker attach [CONTAINER HASH]

You can look up the hashes of running containers with:

docker ps

When attaching to a container, you may need to hit <Enter> to see the shell prompt. To disconnect from the terminal without the container exiting, hit Ctrl+P -> Ctrl+Q.


To make a port accessible outside the container, pass the -p <port> flag. Docker will map this port to another one on the host system. You can look up the interface to which it binds and the port number it maps to with:


If you're going to interact with the Cloudera QuickStart image from other systems, you should make sure quickstart.cloudera resolves to the IP address of the machine where the image is running. You may also want to set up port-forwarding so that the port you would normally connect to on a real cluster, is mapped to the corresponding port

Be aware that when you are mapping ports like this, services are not aware, and may give you links or other references to specific ports that are no longer resolvable on your client.

Other Notes

Docker containers will not have any permanent storage unless you set it up. When the container is killed, any data not found in the image will be lost.

Remember that Cloudera's stack is designed to run on a distributed cluster. Pausing this docker image is like pausing an entire data center: some services may shut down because from their perspective it's been a long time since they were able to communicate with the rest of the cluster.

Cloudera Manager is not started by default. To see options for starting it, run:


/home/cloudera/parcels can then be used if you wish to migrate from a package-based install to a parcel-based install. /home/cloudera/kerberos can be used to install and start Kerberos.

See Cloudera's documentation and Cloudera's website for other information, including the license agreement associated with this image. Cloudera QuickStart is not intended or supported for use in production.

Docker Pull Command

Comments (29)
a month ago

It would be nice to have the hostname set through an environment variable, for example, as I'm trying to run the container on OpenShift and I can't set the hostname to quickstart.cloudera.

Either that or changing the hostname for something without dots.

6 months ago

can't run the container as daemon - it crash after it finish to boot while in interactive mode it stays ok.
second - can't reach 7180 even that I've published it

6 months ago

after update docker, i have the error:
Exception in thread "main" java.lang.RuntimeException: Call From quickstart.cloudera/ to quickstart.cloudera:8020 failed on connection exception: Connection refused; For more details see:

My docker version:
Version: 17.03.1-ce
API version: 1.27
Go version: go1.7.5
Git commit: c6d412e
Built: Tue Mar 28 00:40:02 2017
OS/Arch: darwin/amd64

Version: 17.03.1-ce
API version: 1.27 (minimum version 1.12)
Go version: go1.7.5
Git commit: c6d412e
Built: Fri Mar 24 00:00:50 2017
OS/Arch: linux/amd64
Experimental: true

7 months ago

When I run docker restart on quick cloudera, I no longer connect hbase, the hue api gives me time-api error and receives errors related to zookeeper. Is there any way for recovering services?

9 months ago

How can I make data persist, as we have an environment that is restarted on a daily basis, and I would like not to loose all the data we used for testing, so is it possible to mount a volume? We tried to build it over /var/lib/ but it fails as it does not create all that needs inside that directory inside the container.

9 months ago

+1 on updates

9 months ago

will there be updates for CDH 5.10 ?

a year ago

To start HUE, I have to change file /usr/lib/hue/desktop/core/src/desktop/ line 396 time.sleep(1) to time.sleep(2)

a year ago

How to download that image ?
I need to deploy in as container on one of my test Linux systems.I have already installed Docker and seeking downloading that image.

docker info

Containers: 0
Images: 0
Server Version: 1.9.1
Storage Driver: devicemapper

a year ago

I tried to use /home/cloudera/cloudera-manage to start up the CM and cluster and found hive metastore cannot be launched due to incorrect schema version. I didn't catch the log.

Have someone actually tested it? It is so obvious to find it out by running command " /home/cloudera/cloudera-manager --express"