======Create a new Repository======

**What is a repository?**\\
Simply put; it is a folder kept somewhere which stores not just files and internal folders but also their various versions. Read about it in the [[definitions?do=export_xhtml|definitions topic.]] 

**Who can create a new repository?**\\
You just need a PAT (Personal Access Token) to one of the 3 types of Git Host we support, to create a repository. You automatically becomes the freshly created repository's "owner". If you have been assigned as a manager to someone else, then that person would have given you an //encrypted// PAT. 

  * Read about setting a person as a manager [[setunsetmanager?do=export_xhtml|here.]]
  * Read more about [[/gitlabApiToken1?do=export_xhtml | PAT here. ]]

**What are the mandatory requirements?**\\
//Git Winch// should be aware of the Org. name for which the repository is to be created. 

If you are going to be the owner, then the //Personal Access Token// must be correctly created with the //create repository// permission at your Git Host. Then, you should enter that key in the PAT text-input box on the //Manage// page, and then proceed to create a repository.


If you are a manager, do NOT enter anything in the earlier mentioned text-input box. (i.e. that input box must be left empty)  You would have received the **//encrypted//** version of the PAT from the actual owner. So be ready with that. 

When a manager creates repo, //Git Winch// will specifically ask for the encrypted PAT which had got from the actual owner. Then //Git Winch// will proceed to create a new repository at the Git Host. The original owner will remain the owner of the repository.

**Restrictions**\\
The new repository name must be //lower-case alphanumerical (and you can give underscore too)// You MUST create repositories ONLY from within //Git Winch.// That means you cannot go to the said Git Host and create a repository there or use some other tool to create repositories. 

**IMPORTANT**\\
You cannot clone a repository immediately after you have created it --//even if you are the owner!// You will have to first created deploy keys for yourself and other office workers you want to work in that repository. And; you will also have to //add yourself// (and those workers) as a member of that repository. Such membership addition/deletion can also be done by the delegated manager of that repository (on behalf of the owner)

Hover your mouse over those buttons, and press F1 for their help.

-----
[[/concepts?do=export_xhtml | Learn the concepts]] | [[/topics?do=export_xhtml | Table of Contents]]