docs/usage/interpreter/installation.md

---
layout: page
title: "Installing Interpreters"
description: "Apache Zeppelin provides Interpreter Installation mechanism for whom downloaded Zeppelin netinst binary package, or just want to install another 3rd party interpreters."
group: usage/interpreter 
---
<!--
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

http://www.apache.org/licenses/LICENSE-2.0

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.
-->
{% include JB/setup %}

# Installing Interpreters 

<div id="toc"></div>

Apache Zeppelin provides **Interpreter Installation** mechanism for whom downloaded Zeppelin `netinst` binary package, or just want to install another 3rd party interpreters.

## Community managed interpreters
Apache Zeppelin provides several interpreters as [community managed interpreters](#available-community-managed-interpreters).
If you downloaded `netinst` binary package, you need to install by using below commands.

#### Install all community managed interpreters

```bash
./bin/install-interpreter.sh --all
```

#### Install specific interpreters

```bash
./bin/install-interpreter.sh --name md,shell,jdbc,python
```

You can get full list of community managed interpreters by running

```bash
./bin/install-interpreter.sh --list
```

#### Install interpreter built with Scala 2.10
Zeppelin support both Scala 2.10 and 2.11 for several interpreters as below:

<table class="table-configuration">
  <tr>
    <th>Name</th>
    <th>Maven Artifact for Scala 2.10</th>
    <th>Maven Artifact for Scala 2.11</th>
  </tr>
  <tr>
    <td>spark</td>
    <td>org.apache.zeppelin:zeppelin-spark_2.10:0.9.0</td>
    <td>org.apache.zeppelin:zeppelin-spark_2.11:0.9.0</td>
  </tr>
  <tr>
    <td>scalding</td>
    <td>org.apache.zeppelin:zeppelin-scalding_2.10:0.9.0</td>
    <td>org.apache.zeppelin:zeppelin-scalding_2.11:0.9.0</td>
  </tr>
</table>

If you install one of these interpreters only with `--name` option, installer will download interpreter built with Scala 2.11 by default. If you want to specify Scala version, you will need to add `--artifact` option. Here is the example of installing flink interpreter built with Scala 2.10.

```bash
./bin/install-interpreter.sh --name flink --artifact org.apache.zeppelin:zeppelin-scalding_2.10:0.9.0
```

#### Install Spark interpreter built with Scala 2.10

Spark distribution package has been built with Scala 2.10 until 1.6.2. If you have `SPARK_HOME` set pointing to Spark version earlier than 2.0.0, you need to download Spark interpreter packaged with Scala 2.10. To do so, use follow command:

```bash
rm -rf ./interpreter/spark
./bin/install-interpreter.sh --name spark --artifact org.apache.zeppelin:zeppelin-spark_2.10:0.9.0
```

<br />
Once you have installed interpreters, you need to restart Zeppelin. And then [create interpreter setting](./overview.html#what-is-zeppelin-interpreter) and [bind it with your notebook](./overview.html#what-is-zeppelin-interpreter-setting).


## 3rd party interpreters

You can also install 3rd party interpreters located in the maven repository by using below commands.

#### Install 3rd party interpreters

```bash
./bin/install-interpreter.sh --name interpreter1 --artifact groupId1:artifact1:version1
```

The above command will download maven artifact `groupId1:artifact1:version1` and all of its transitive dependencies into `interpreter/interpreter1` directory.

After restart Zeppelin, then [create interpreter setting](./overview.html#what-is-zeppelin-interpreter) and [bind it with your note](./overview.html#what-is-interpreter-setting).

#### Install multiple 3rd party interpreters at once

```bash
./bin/install-interpreter.sh --name interpreter1,interpreter2 --artifact groupId1:artifact1:version1,groupId2:artifact2:version2
```

`--name` and `--artifact` arguments will recieve comma separated list.

## Available community managed interpreters

You can also find the below community managed interpreter list in `conf/interpreter-list` file.
<table class="table-configuration">
  <tr>
    <th>Name</th>
    <th>Maven Artifact</th>
    <th>Description</th>
  </tr>
  <tr>
    <td>alluxio</td>
    <td>org.apache.zeppelin:zeppelin-alluxio:0.9.0</td>
    <td>Alluxio interpreter</td>
  </tr>
  <tr>
    <td>angular</td>
    <td>org.apache.zeppelin:zeppelin-angular:0.9.0</td>
    <td>HTML and AngularJS view rendering</td>
  </tr>
  <tr>
    <td>beam</td>
    <td>org.apache.zeppelin:zeppelin-beam:0.9.0</td>
    <td>Beam interpreter</td>
  </tr>
  <tr>
    <td>bigquery</td>
    <td>org.apache.zeppelin:zeppelin-bigquery:0.9.0</td>
    <td>BigQuery interpreter</td>
  </tr>
  <tr>
    <td>cassandra</td>
    <td>org.apache.zeppelin:zeppelin-cassandra:0.9.0</td>
    <td>Cassandra interpreter</td>
  </tr>
  <tr>
    <td>elasticsearch</td>
    <td>org.apache.zeppelin:zeppelin-elasticsearch:0.9.0</td>
    <td>Elasticsearch interpreter</td>
  </tr>
  <tr>
    <td>file</td>
    <td>org.apache.zeppelin:zeppelin-file:0.9.0</td>
    <td>HDFS file interpreter</td>
  </tr>
  <tr>
    <td>flink</td>
    <td>org.apache.zeppelin:zeppelin-flink:0.9.0</td>
    <td>Flink interpreter</td>
  </tr>
  <tr>
    <td>hbase</td>
    <td>org.apache.zeppelin:zeppelin-hbase:0.9.0</td>
    <td>Hbase interpreter</td>
  </tr>
  <tr>
    <td>geode</td>
    <td>org.apache.zeppelin:zeppelin-geode:0.9.0</td>
    <td>Apache Geode interpreter</td>
  </tr>
  <tr>
    <td>groovy</td>
    <td>org.apache.zeppelin:zeppelin-groovy:0.9.0</td>
    <td>Groovy interpreter</td>
  </tr>
  <tr>
    <td>ignite</td>
    <td>org.apache.zeppelin:zeppelin-ignite:0.9.0</td>
    <td>Ignite interpreter</td>
  </tr>
  <tr>
    <td>java</td>
    <td>org.apache.zeppelin:zeppelin-java:0.9.0</td>
    <td>Java interpreter</td>
  </tr>
  <tr>
    <td>jdbc</td>
    <td>org.apache.zeppelin:zeppelin-jdbc:0.9.0</td>
    <td>Jdbc interpreter</td>
  </tr>
  <tr>
    <td>kotlin</td>
    <td>org.apache.zeppelin:zeppelin-kotlin:0.7.0</td>
    <td>Kotlin interpreter</td>
  </tr>
  <tr>
    <td>kylin</td>
    <td>org.apache.zeppelin:zeppelin-kylin:0.9.0</td>
    <td>Kylin interpreter</td>
  </tr>
  <tr>
    <td>lens</td>
    <td>org.apache.zeppelin:zeppelin-lens:0.9.0</td>
    <td>Lens interpreter</td>
  </tr>
  <tr>
    <td>livy</td>
    <td>org.apache.zeppelin:zeppelin-livy:0.9.0</td>
    <td>Livy interpreter</td>
  </tr>
  <tr>
    <td>md</td>
    <td>org.apache.zeppelin:zeppelin-markdown:0.9.0</td>
    <td>Markdown support</td>
  </tr>
  <tr>
    <td>neo4j</td>
    <td>org.apache.zeppelin:zeppelin-neo4j:0.9.0</td>
    <td>Neo4j interpreter</td>
  </tr>
  <tr>
    <td>pig</td>
    <td>org.apache.zeppelin:zeppelin-pig:0.9.0</td>
    <td>Pig interpreter</td>
  </tr>
  <tr>
    <td>python</td>
    <td>org.apache.zeppelin:zeppelin-python:0.9.0</td>
    <td>Python interpreter</td>
  </tr>
  <tr>
    <td>sap</td>
    <td>org.apache.zeppelin:zeppelin-sap:0.9.0</td>
    <td>SAP support</td>
  </tr>
  <tr>
    <td>scalding</td>
    <td>org.apache.zeppelin:zeppelin-scalding_2.0.10:0.9.0</td>
    <td>Scalding interpreter</td>
  </tr>
  <tr>
    <td>scio</td>
    <td>org.apache.zeppelin:zeppelin-scio:0.9.0</td>
    <td>Scio interpreter</td>
  </tr>
  <tr>
    <td>shell</td>
    <td>org.apache.zeppelin:zeppelin-shell:0.9.0</td>
    <td>Shell command</td>
  </tr>
  <tr>
    <td>sparql</td>
    <td>org.apache.zeppelin:zeppelin-sparql:0.9.0</td>
    <td>Sparql interpreter</td>
  </tr>
  <tr>
    <td>submarine</td>
    <td>org.apache.zeppelin:zeppelin-submarine:0.9.0</td>
    <td>Submarine interpreter</td>
  </tr>
</table>