Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Let’s big data. Hue is a Web interface for analyzing data with Apache Hadoop. It supports a file and job browser, Hive, Pig, Impala, Spark, Oozie editors, Solr Search dashboards, HBase, Sqoop2, and more.
Python HTML Java JavaScript Mako C Other
branch: master
Failed to load latest commit information.
apps HUE-2695 [oozie] Don't display Action params when None in Workflow Ac…
desktop [desktop] Allow the SECRET_KEY to be generated from a script
dist [doc] Help command to fix setup for tarball install
docs HUE-2417 [all] Switch the static files to use the new /static prefix
ext/thirdparty HUE-2436 [ext] Update the external dependency documentation
maven [livy] Update spark version to 1.3.0-cdh5.5.0-SNAPSHOT
tools HUE-2687 [core] Add to collect data and license i…
.gitattributes hue (formerly Cloudera Desktop) from internal commit 4694ac0434dad851…
.gitignore [livy] Ignore the dependency-reduced-pom.xml
.jslintrc hue (formerly Cloudera Desktop) from internal commit 4694ac0434dad851… [core] Adding link to contributing guidelines on github
LICENSE.txt hue (formerly Cloudera Desktop) from internal commit 4694ac0434dad851…
Makefile [core] i18n of the desktop libs
Makefile.sdk HUE-758 [core] Internationalization
Makefile.tarball HUE-2068 [infra] Third-party dependencies manifest is excluded from b…
Makefile.vars [core] Remove python 2.4 and 2.5 from python selection
Makefile.vars.priv hue (formerly Cloudera Desktop) from internal commit 4694ac0434dad851…
NOTICE.txt [core] Add third-party dependency references
README.rst [doc] Bump Django and Python versions
VERSION [core] Bumping version to 3.7
data Make app registry location configurable



Welcome to the repository for Hue

Hue is an open source Web interface for analyzing data with Apache Hadoop:


It features:

  • File Browser for accessing HDFS
  • Hive Editor for developing and running Hive queries
  • Search App for querying, exploring, visualizing data and dashboards with Solr
  • Impala App for executing interactive SQL queries
  • Spark Editor and Dashboard
  • Pig Editor for submitting Pig scripts
  • Oozie Editor and Dashboard for submitting and monitoring workflows, coordinators and bundles
  • HBase Browser for visualizing, querying and modifying HBase tables
  • Metastore Browser for accessing Hive metadata and HCatalog
  • Job Browser for accessing MapReduce jobs (MR1/MR2-YARN)
  • Job Designer for creating MapReduce/Streaming/Java jobs
  • A Sqoop 2 Editor and Dashboard
  • A ZooKeeper Browser and Editor
  • A DB Query Editor for MySql, PostGres, Sqlite and Oracle

On top of that, a SDK is available for creating new apps integrated with Hadoop.

More user and developer documentation is available at

Getting Started

To build and get the development server running:

$ git clone
$ cd hue
$ make apps
$ build/env/bin/hue runserver

Now Hue should be running on http://localhost:8000 !

The configuration in development mode is desktop/conf/pseudo-distributed.ini.

Note: to start the production server (but lose the automatic reloading after source modification):

$ build/env/bin/supervisor

To run the tests:

Install the mini cluster (only once):
$ ./tools/jenkins/ slow

Run all the tests:
$ build/env/bin/hue test all

Or just some parts of the tests, e.g.:
$ build/env/bin/hue test specific impala
$ build/env/bin/hue test specific impala.tests:TestMockedImpala
$ build/env/bin/hue test specific impala.tests:TestMockedImpala.test_basic_flow

Development Prerequisites

You'll need these library development packages and tools installed on your system:

  • ant
  • gcc
  • g++
  • libkrb5-dev
  • libmysqlclient-dev
  • libssl-dev
  • libsasl2-dev
  • libsasl2-modules-gssapi-mit
  • libsqlite3-dev
  • libtidy-0.99-0 (for unit tests only)
  • libxml2-dev
  • libxslt-dev
  • mvn (from maven package or maven3 tarball)
  • openldap-dev / libldap2-dev
  • python-dev
  • python-setuptools
  • ant
  • asciidoc
  • cyrus-sasl-devel
  • cyrus-sasl-gssapi
  • gcc
  • gcc-c++
  • krb5-devel
  • libtidy (for unit tests only)
  • libxml2-devel
  • libxslt-devel
  • mvn (from maven package or maven3 tarball)
  • mysql
  • mysql-devel
  • openldap-devel
  • python-devel
  • sqlite-devel
  • openssl-devel (for version 7+)
  • Xcode command line tools
  • Oracle's JDK 1.7+
  • maven (Homebrew)
  • mysql (Homebrew)

File Layout

The Hue "framework" is in desktop. /core/ contains the Web components and desktop/libs/ the API for talking to Hadoop. The installable apps live in apps/. Please place third-party dependencies in the app's ext-py/ directory.

The typical directory structure for inside an application includes:

for Python/Django code
for configuration (.ini) files to be installed
for static HTML/js resources and help doc
for data to be put through a template engine
for localizations in multiple languages

For the URLs within your application, you should make your own which will be automatically rooted at /yourappname/ in the global namespace. See apps/about/src/about/ for an example.

Main Stack

Hue would not be possible without:



Apache License, Version 2.0

Something went wrong with that request. Please try again.