Browser interface for HDFS
Fetching latest commit…
Cannot retrieve the latest commit at this time.


Action core

The Action core exposes HDFS over HTTP. It provides a REST interface as well as a browsing UI. Unlike the browser shipped with the Hadoop namenode, it integrates a de-serialization mechanism to read files content.

More detailed documentation can be found here.


war artifacts can be found at Maven Central.


mvn install

Configuration options

See for configuration options.


mvn -Daction.hadoop.namenode.url=hdfs:// jetty:run

You can now browse HDFS:

Query parameters

  • path: path to open in HDFS

  • range: when opening a file, bucket of lines to display (e.g. range=1-50 for the first 51 lines)

  • raw: whether to display the nice, HTML version (raw=true) or plain text (raw=false)

  • recursive: whether to craw a directory recursively. If you want to download all content under /user/pierre:

    curl ''

Notes on serialization

You can specify your custom Hadoop serialization classes (which implement<T>) on the command line (make sure to escape the comma):\,

You can also implement custom renderers, see the documentation for more details.

Documenting schemas

When clicking on a row, an exploded content of the row is show as JSON. By default, each column is labeled as “Field_…”. This can be overridden by implementing the Registrar interface.

The Action core supports out of the box Goodwill (see which is an HTTP based type registrar.

License (see COPYING file for full license)

Copyright 2010-2012 Ning

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.