Shell interpreter for Apache Zeppelin


Shell interpreter uses Apache Commons Exec to execute external processes. In Zeppelin notebook, you can use %sh in the beginning of a paragraph to invoke system shell and run commands.

Note : Currently each command runs as the user Zeppelin server is running as.


At the "Interpreters" menu in Zeppelin dropdown menu, you can set the property value for Shell interpreter.

Name Value Description
shell.command.timeout.millisecs 60000 Shell command time out in millisecs Types of authentications' methods supported are SIMPLE, and KERBEROS The principal name to load from the keytab The path to the keytab file


The following example demonstrates the basic usage of Shell in a Zeppelin notebook.

If you need further information about Zeppelin Interpreter Setting for using Shell interpreter, please read What is interpreter setting? section first.

Kerberos refresh interval

For changing the default behavior of when to renew Kerberos ticket following changes can be made in conf/

# Change Kerberos refresh interval (default value is 1d). Allowed postfix are ms, s, m, min, h, and d.
# Change kinit number retries (default value is 5), which means if the kinit command fails for 5 retries consecutively it will close the interpreter.