Quick Start

Welcome to Apache Zeppelin! On this page are instructions to help you get started.

Installation

Apache Zeppelin officially supports and is tested on the following environments:

Name Value
Oracle JDK 1.7
(set JAVA_HOME)
OS Mac OSX
Ubuntu 14.X
CentOS 6.X
Windows 7 Pro SP1

Downloading Binary Package

Two binary packages are available on the Apache Zeppelin Download Page. Only difference between these two binaries is interpreters are included in the package file.

  • Package with all interpreters.

    Just unpack it in a directory of your choice and you're ready to go.

  • Package with net-install interpreters.

    Unpack and follow install additional interpreters to install interpreters. If you're unsure, just run ./bin/install-interpreter.sh --all and install all interpreters.

Starting Apache Zeppelin

Starting Apache Zeppelin from the Command Line

On all unix like platforms:

bin/zeppelin-daemon.sh start

If you are on Windows:

bin\zeppelin.cmd

After Zeppelin has started successfully, go to http://localhost:8080 with your web browser.

Stopping Zeppelin

bin/zeppelin-daemon.sh stop

Start Apache Zeppelin with a service manager

Note : The below description was written based on Ubuntu Linux.

Apache Zeppelin can be auto-started as a service with an init script, using a service manager like upstart.

This is an example upstart script saved as /etc/init/zeppelin.conf This allows the service to be managed with commands such as

sudo service zeppelin start  
sudo service zeppelin stop  
sudo service zeppelin restart

Other service managers could use a similar approach with the upstart argument passed to the zeppelin-daemon.sh script.

bin/zeppelin-daemon.sh upstart

zeppelin.conf

description "zeppelin"

start on (local-filesystems and net-device-up IFACE!=lo)
stop on shutdown

# Respawn the process on unexpected termination
respawn

# respawn the job up to 7 times within a 5 second period.
# If the job exceeds these values, it will be stopped and marked as failed.
respawn limit 7 5

# zeppelin was installed in /usr/share/zeppelin in this example
chdir /usr/share/zeppelin
exec bin/zeppelin-daemon.sh upstart

Next Steps

Congratulations, you have successfully installed Apache Zeppelin! Here are few steps you might find useful:

New to Apache Zeppelin...

Zeppelin with Apache Spark ...

Zeppelin with JDBC data sources ...

  • Check JDBC Interpreter to know more about configure and uses multiple JDBC data sources.

Zeppelin with Python ...

  • Check Python interpreter to know more about Matplotlib, Pandas, Conda/Docker environment integration.

Multi-user environment ...

Other useful information ...

Building Apache Zeppelin from Source

If you want to build from source instead of using binary package, follow the instructions here.