How-to Install Apache Hadoop on Mac OS X 10.11 El Capitan Step-by-Step Guide

Hadoop 2.X QuickStart on Mac OS X 10.11 El Capitan

The Mac Tutorial Shows You Step-by-Step How-to Install and Getting-Started with Apache Hadoop/Map-Reduce vanilla in Pseudo-Distributed mode on Mac OS X 10.11 El Capitan 32/64bit Desktop.

Hadoop is a distributed master-slave that consists of the Hadoop Distributed File System (HDFS) for storage and Map-Reduce for computational capabilities.

The Guide Describe a System-Wide Installation with Root Privileges but You Can Easily Convert the Procedure to a Local One.

Apache Hadoop Require the Java JDK 7+ Installed so if Needed Follow the guide on How-to Install Oracle JDK on Mac.

Hadoop Getting-Started on Mac OS X 10.11 El Capitan - Featured

Apache Hadoop 2.x Includes the following Modules:

  • Hadoop Common: The common utilities that support the other Hadoop modules.
  • Hadoop Distributed File System (HDFS): A distributed file system that provides high-throughput access to application data.
  • Hadoop YARN: A framework for job scheduling and cluster resource management.
  • Hadoop MapReduce: A YARN-based system for parallel processing of large data sets.
  1. Download Latest Apache Hadoop Stable Release:

    Apache Hadoop Stable tar.gz

  2. Double-Click on Archive to Extract

  3. Open Terminal Window
    (Press “Enter” to Execute Commands)

    Install Hadoop for Mac OS X 10.11 El Capitan - Open Terminal
  4. Relocate Apache Hadoop Directory

    rm $HOME/Downloads/hadoop*tar.gz
    sudo mv $HOME/Downloads/hadoop* /usr/local/hadoop
    sudo mkdir /usr/local/hadoop/tmp
    sudo chown -R root:wheel /usr/local/hadoop*
  5. Check if Java JDK 7+ is Installed

    java --version

    How-to Install Required Oracle JDK 7+ on MacOS X:

    Install Oracle JDK 7+ for Mac
  6. Set JAVA_HOME in Hadoop Env File

    sudo su

    If Got “User is Not in Sudoers file” then Look: Solution

    mkdir /usr/local/hadoop/conf
    nano /usr/local/hadoop/conf/


    export JAVA_HOME=$(/usr/libexec/java_home)

    Ctrl+x to Save & Exit 🙂

  7. Configuration for Pseudo-Distributed mode

    nano /usr/local/hadoop/conf/core-site.xml

    The Content Should Look Like:



    nano /usr/local/hadoop/conf/hdfs-site.xml

    The Content Should Look Like:



    nano /usr/local/hadoop/conf/mapred-site.xml

    The Content Should Look Like:

  8. SetUp Local Path & Environment

    cd $HOME
    nano .profile


    export PATH=$PATH:$HADOOP_HOME/bin:$HADOOP_HOME/sbin

    The JAVA_HOME is Set Following Oracle Java JDK6+ Installation Version…

    Then Load New Setup:

    source $HOME/.profile
  9. SetUp Needed Local SSH Connection
    Enable SSH Connection:

    System Preferences >> Sharing

    Mac El Capitan 10.11 Hadoop Quick-Start - Enabling Remote Login
    To Enable SSH Login without Pass:

    ssh-keygen -t rsa

    Press enter for each line…

    cat ~/.ssh/ >> ~/.ssh/authorized_keys
    chmod og-wx ~/.ssh/authorized_keys

    Testing Connection:

  10. Formatting HDFS
    cd /usr/local/hadoop
    sudo su
    bin/hadoop namenode -format

    Install Hadoop for Mac OS X 10.12 Sierra - Terminal Apache Hadoop HDFS Formatting Succcess

  11. Starting Up Hadoop Database
  12. Apache Hadoop Database Quick-Start Guide:

    Hadoop MapReduce Quick-Start
  13. Eclipse Hadoop 2.X Integration with Free Plugin:

    Hadoop 2.X Eclipse Plugin SetUp