---

layout: page title: “Notebook as Homepage” description: "" group: manual

{% include JB/setup %}

Customize your zeppelin homepage

Zeppelin allows you to use one of the notebooks you create as your zeppelin Homepage. With that you can brand your zeppelin installation, adjust the instruction to your users needs and even translate to other languages.

The process for creating your homepage is very simple as shown below:

1. Create a notebook using zeppelin
2. Set the notebook id in the config file
3. Restart zeppelin

You can also use the display system to generate text, html,table or angular

Run (shift+Enter) the notebook and see the output. Optionally, change the notebook view to report to hide the code sections.

for example

Set the notebook id to the ZEPPELIN_NOTEBOOK_HOMESCREEN environment variable or zeppelin.notebook.homescreen property.

You can also set the ZEPPELIN_NOTEBOOK_HOMESCREEN_HIDE environment variable or zeppelin.notebook.homescreen.hide property to hide the new notebook from the notebook list.

./bin/zeppelin-deamon stop 
./bin/zeppelin-deamon start

####That's it! Open your browser and navigate to zeppelin and see your customized homepage...

println(
"""%angular 
  <div class="col-md-4" ng-controller="HomeCtrl as home">
    <h4>Notebooks</h4>
    <div>
      <h5><a href="" data-toggle="modal" data-target="#noteNameModal" style="text-decoration: none;">
        <i style="font-size: 15px;" class="icon-notebook"></i> Create new note</a></h5>
        <ul style="list-style-type: none;">
          <li ng-repeat="note in home.notes.list track by $index"><i style="font-size: 10px;" class="icon-doc"></i>
            <a style="text-decoration: none;" href="#/notebook/{{note.id}}">{{note.name || 'Note ' + note.id}}</a>
          </li>
        </ul>
    </div>
  </div>
""")

After running the notebook you will see output similar to this one:

The main trick here relays in linking the <div> to the controller:

<div class="col-md-4" ng-controller="HomeCtrl as home">

Once we have home as our controller variable in our <div></div> we can use home.notes.list to get access to the notebook list.