---
layout: default
navsection: userguide
title: Add new arvados repository
...

Arvados repositories are managed through the Git revision control system. You can use these repositories to store your crunch scripts and run them in the arvados cluster.

{% include 'tutorial_expectations' %}

h2. Setting up Git

Before you start using Git and arvados repositories, you should do some basic configuration (you only need to do this the first time):

<notextile>
<pre><code>~$ <span class="userinput">git config --global user.name "Your Name"</span>
~$ <span class="userinput">git config --global user.email $USER@example.com</span></code></pre>
</notextile>

h2. Add "tutorial" repository

On the Arvados Workbench, click on the dropdown menu icon <span class="fa fa-lg fa-user"></span> <span class="caret"></span> in the upper right corner of the top navigation menu to access the user settings menu, and click on the menu item *Manage account* to go to the account management page.

On the *Manage account* page, you will see *Repositories* panel with a *Add new repository* button.

!{{ site.baseurl }}/images/repositories-panel.png!

Click the *Add new Repository* button to open the popup to add a new arvados repository. You will see a text box where you can enter the name of the repository. Enter *tutorial* in this text box and click on *Create*.

{% include 'notebox_begin' %}
The name you enter here can only be of the format *a letter followed by alphanumeric characters*.
{% include 'notebox_end' %}

!{{ site.baseurl }}/images/add-new-repository.png!

This will create a new repository with the name @$USER/tutorial@ with the URL <notextile><code>git@git.{{ site.arvados_api_host }}:$USER/tutorial.git</code></notextile>

Back in the *Repositories* panel in the *manage account* page, you should see the @$USER/tutorial@ repository listed in the name column with the URL <notextile><code>git@git.{{ site.arvados_api_host }}:$USER/tutorial.git</code></notextile>.

You are now ready to use this *tutorial* repository to run your crunch scripts.