**Here you will learn how to create a simple repository and handle permissions**
# Creating a repository on c4science
Click on the //Create a GIT Repository// button on your landing page.
{F1326707}
Choose to create a Git (preferred), SVN or Mercurial repository
{F135917}
All you need to indicate in the next screen is a name for your repository
{F135919}
Now, let's set some policies
{F135921}
Default policies are access to repository author only. You may want to edit that. The first step is to define the visibility of the repository. There are several fine grain options to adjust the visibility.
Visible means read access, Editable means manage (via the web interface), Pushable is access to the repo in write mode.
Other options are in particular: "Public", which will make the repository accessible to anyone (even logged out) and "All Users" are all logged-in registered users of c4science.
{F211261}
We wish to give read access to some individual users. For that, we have to create a custom policy
{F135927}
...we can just add some users to the //Allow// list:
{F135929}
You can also set similar policies for Edit (this means: managers of the repository) and Push (this means contributors).
{F135931}
Now, you can go back to //Basics// and //Activate Repository//.
{F135933}
Let's have a look at your repository now by clicking on //View Repository//.
{F135936}
You can see access URLs for https (you need a [[ https://c4science.ch/w/c4science/whatisvcs/ | VCS password]] for this) and ssh (you need to [[c4science/sshkeys/|upload a SSH key]] for this), Those are the URLs to be put after `git clone` in your command line. The //Manage Repository// link will take you back to the configuration menu.
{F135944}
# Using your repository
Now that your repository is set up, you can clone it to your machine with the command
`git clone https://c4science.ch/diffusion/997/simplegitrepo.git`.
Replace `https://c4science.ch/diffusion/997/simplegitrepo.git` with the URL shown in your actual repository. You will need to enter your c4science username and the VCS password or configure ssh properly if needed.
You can then enter the newly created directory and create, for example, a `README.md` file. Then, add the file
`git add README.md`
commit your changes
`git commit -m "README.md file added"`
and push everything to the server
`git push`
...after some time (less than a minute), you can see the files on the web interface.
NOTE: If you want to manage access from multiple people, you may want to use a [[c4science/Project]]