# Create your first Repository

## Create a new Repository

When you are logged in you can just click on the "+" sign on the right side of repositories.

[![image-1649582892662.png](https://bookstack.voser.cloud/uploads/images/gallery/2022-04/scaled-1680-/8ZxfSebh3PPSupT7-image-1649582892662.png)](https://bookstack.voser.cloud/uploads/images/gallery/2022-04/8ZxfSebh3PPSupT7-image-1649582892662.png)

### Configure Repository

Here you find all the settings described.

#### Owner

Select the owner of the Repository, you can either select your own user or a organization, where you have the rights to create a repository.

[![image-1649583095444.png](https://bookstack.voser.cloud/uploads/images/gallery/2022-04/scaled-1680-/uAz1Bi44ND2zEMPj-image-1649583095444.png)](https://bookstack.voser.cloud/uploads/images/gallery/2022-04/uAz1Bi44ND2zEMPj-image-1649583095444.png)

#### Repository-Name

Select a name, this can be anything.

[![image-1649583214391.png](https://bookstack.voser.cloud/uploads/images/gallery/2022-04/scaled-1680-/ZvLDNPTb8S5jjR26-image-1649583214391.png)](https://bookstack.voser.cloud/uploads/images/gallery/2022-04/ZvLDNPTb8S5jjR26-image-1649583214391.png)

#### Private Repository

If your repository contains sensitive data, you should set the checkbox for private repository. If this checkbox is not set, everybody with access to this website could read your code. If you set this checkbox, only you and administrators can see this repository.

[![image-1649583385328.png](https://bookstack.voser.cloud/uploads/images/gallery/2022-04/scaled-1680-/sizDtpOliCIwIk3k-image-1649583385328.png)](https://bookstack.voser.cloud/uploads/images/gallery/2022-04/sizDtpOliCIwIk3k-image-1649583385328.png)

#### Description

This description gets written in the README.md, this can be changed late, type a descriptive sentence.

[![image-1649583520426.png](https://bookstack.voser.cloud/uploads/images/gallery/2022-04/scaled-1680-/RwreQupqZljuv107-image-1649583520426.png)](https://bookstack.voser.cloud/uploads/images/gallery/2022-04/RwreQupqZljuv107-image-1649583520426.png)

#### Template

If you would have a template repository, you could use this as base. If you have none, just the default will be used.

[![image-1649583700713.png](https://bookstack.voser.cloud/uploads/images/gallery/2022-04/scaled-1680-/BWrRBttccBsXSekn-image-1649583700713.png)](https://bookstack.voser.cloud/uploads/images/gallery/2022-04/BWrRBttccBsXSekn-image-1649583700713.png)

#### Issue Label

The Issue-Label-Set is used when creating a Issue, you can categorize the issues with the following tags. Just select the default.

[![image-1649583790849.png](https://bookstack.voser.cloud/uploads/images/gallery/2022-04/scaled-1680-/8AtQZ6LMF1lkPS6n-image-1649583790849.png)](https://bookstack.voser.cloud/uploads/images/gallery/2022-04/8AtQZ6LMF1lkPS6n-image-1649583790849.png)

#### Gitignore File

The .gitignore file is used to ignore some files like build binaries and cache or sensitive date. All the files defined in this file do not get uploaded to your git repository. My recommendation is to just select the default for your programming language, you can adjust this on every commit.

[![image-1649583857622.png](https://bookstack.voser.cloud/uploads/images/gallery/2022-04/scaled-1680-/2BsRNwLLTlutu5Ic-image-1649583857622.png)](https://bookstack.voser.cloud/uploads/images/gallery/2022-04/2BsRNwLLTlutu5Ic-image-1649583857622.png)

#### License

To protect your intellectual Property you can select a license for your repository, my recommendation is to use Apache-2.0.

[![image-1649584138503.png](https://bookstack.voser.cloud/uploads/images/gallery/2022-04/scaled-1680-/MeCdPMUs81KVEy7g-image-1649584138503.png)](https://bookstack.voser.cloud/uploads/images/gallery/2022-04/MeCdPMUs81KVEy7g-image-1649584138503.png)

#### README

The README file is a markdown file in your repository, which has the description in it. you can customize this to your needs.

Additionally check the checkbox to initialize your repostitory, otherwise it will not create the files.

[![image-1649584187436.png](https://bookstack.voser.cloud/uploads/images/gallery/2022-04/scaled-1680-/54aWoElJKrM2nzMT-image-1649584187436.png)](https://bookstack.voser.cloud/uploads/images/gallery/2022-04/54aWoElJKrM2nzMT-image-1649584187436.png)

#### Defaultbranch

The default branch describes to which branch the push request are getting routed. Use master for default.

[![image-1649584334638.png](https://bookstack.voser.cloud/uploads/images/gallery/2022-04/scaled-1680-/HGV4ngrhYSi7VwyR-image-1649584334638.png)](https://bookstack.voser.cloud/uploads/images/gallery/2022-04/HGV4ngrhYSi7VwyR-image-1649584334638.png)

#### Default trust model

The default trust model describes how the trusts are related. Use the default.

[![image-1649584494935.png](https://bookstack.voser.cloud/uploads/images/gallery/2022-04/scaled-1680-/rdCxCKFGNsfzdayL-image-1649584494935.png)](https://bookstack.voser.cloud/uploads/images/gallery/2022-04/rdCxCKFGNsfzdayL-image-1649584494935.png)

#### Template

You could convert this repository settings to a template, but remember a template can not be edited. If you just want a Project to work on do not check this box.

[![image-1649584551502.png](https://bookstack.voser.cloud/uploads/images/gallery/2022-04/scaled-1680-/zJlBBpoawwFyLydW-image-1649584551502.png)](https://bookstack.voser.cloud/uploads/images/gallery/2022-04/zJlBBpoawwFyLydW-image-1649584551502.png)

Afterwards click on "create repository".

### The final result

The final result looks something like this.

[![image-1649584726819.png](https://bookstack.voser.cloud/uploads/images/gallery/2022-04/scaled-1680-/DwvlQHhmdVcLF1zb-image-1649584726819.png)](https://bookstack.voser.cloud/uploads/images/gallery/2022-04/DwvlQHhmdVcLF1zb-image-1649584726819.png)