Apache Zeppelin Component Guide
Also available as:
loading table of contents...

Launching Zeppelin

To launch Zeppelin in your browser, access the host and port associated with the Zeppelin server. The default port is 9995:


When you first connect to Zeppelin, you will see the home page:

If Zeppelin is configured for LDAP or Active Directory authentication, log in before using Zeppelin:

  1. Click the Login button at the top right corner of the page.

  2. In the login dialog box, specify a valid username and password.

    If Active Directory is used for the identity store, you might need to fully qualify your account name (unless the activeDirectoryRealm.principalSuffix property was set during AD configuration); for example:

  3. Zeppelin presents its home page.

The following menus are available in the top banner of all Zeppelin pages:

  • Notebook

    Open a note, filter the list of notes by name, or create a note:

  • User settings

    Displays your username, or "anonymous" if security is not configured for Zeppelin.

    • List version information about Zeppelin

    • Review interpreter settings and configure, add, or remove interpreter instances

    • Save credentials for data sources

    • Display configuration settings

Each instance of Zeppelin contains "notes", which are the fundamental elements of a Zeppelin notebook.

Zeppelin lists available notes on the left side of the welcome screen and in the "Notebook" menu. Zeppelin ships with several sample notes, including tutorials: