Community Articles
Find and share helpful community-sourced technical articles.
Check out our newest addition to the community, the Cloudera Innovation Accelerator group hub.
Labels (1)

This article describes to store your zeppelin notes in a GitHub repo.

1) Create a GitHub repo where you want to store your zeppelin notes. I have created a repo named 'zeppelin-notes'.

Select ssh for cloning. We will be using ssh key to perform git operations.43741-github-repo-creation.png

2) Copy the ssh public key from the node where Zeppelin is installed and add it in git hub. The command displays the public key and screenshot tells how to add the ssh key to github

# su zeppelin
# cat ~/.ssh/


Click on "New SSH Key" , give a title for the key and paste the content and click save.

3) Clone the git repo in the node where zeppelin is installed and set proper permissions to the folder

su zeppelin
cd /usr/hdp/current/zeppelin-server/
git clone 
chown zeppelin:zeppelin zeppelin-notes
chmod -R 777 zeppelin-notes

4) Change the zeppelin notebook directory path. Go to Ambari -> Zeppelin -> Configs -> Advanced zeppelin-config and set the value for zeppelin.notebook.dir to the git hub repo name (ie zeppelin-notes)


5) Change the storage for zeppelin. Go to Ambari -> Zeppelin -> Configs -> Advanced zeppelin-config and set the value for to org.apache.zeppelin.notebook.repo.GitNotebookRepo.


Perform steps 4 and 5 and restart Zeppelin

6) Login to zeppelin and create a new Notebook. I named it 'FirstNote'.

7) After making some changes now you may want to commit the note. Click on the icon shown in the screenshot below and write your commit message and click Commit.


😎 Check if your commit was successful.

cd /usr/hdp/current/zeppelin-server/zeppelin-notes
git log


9) You can check the state of the notebook at a particular commit by setting the revision to the particular commit. Check the screenshot.


10) You can push your commits to the repo by running the following commands

cd /usr/hdp/current/zeppelin-server/zeppelin-notes
git push origin {branch-name}

Hope this helps 🙂

Refernce :



Not applicable

Hey, I am unable to change the zeppelin config for some reason. I tried to edit the zeppelin-site.xml.template file in the conf folder, but the changes aren't reflecting in the zepplin even after restarting. Am i missing something?

Don't have an account?
Version history
Last update:
‎08-17-2019 09:59 AM
Updated by:
Top Kudoed Authors