Search…
Create a New Repository

What is a "Repository"?

A "repository" is simply a folder structure stored in Git. The "root" of a repository is the base folder you want to store. A repository is different from a typical directory, as it stores hidden context about the changes to the root folder and all of the subfolders under the root.

What is "Creating a Repository"?

When you "create a repository" you are essentially creating a folder that you can add files and subfolders to. There are a few options when creating a repository:
  • Create a new repository in the Copia web app
  • Create a new repository using the Copia desktop app
  • Create a new repository, from an existing folder, using the Copia desktop app
When you create a repository using the Copia web app, you can "clone" (or copy) that repository to your local. When you create a repository using the Copia desktop app, you will typically "Publish" that repository to the Copia server.
At this time only account holders with admin level access can create repositories.

When to create a repository

Typically, in the control's world, you may use one repository to represent a project for a client, a manufacturing site, or a zone within a manufacturing site. However, as you grow more comfortable with Git, we expect you'll define your own best practices that make sense for your organization.
If you are new to Git, we recommend getting started by storing a single project in a repository. (It is always easier to merge repositories later, versus breaking a repository apart) This repository should contain the automation project data (for example, a Rockwell ACD or a Siemens Step7 TIA Portal Project folder).

Create a repo using the Copia web app

Creating a repository is quite simple and you'll find yourself doing it a lot. In fact, it involves only three steps.
Click the + button in the upper right-hand corner of any page on the Copia web app. Choose New Repository.
You can also create a repository from the dashboard by clicking the + button in the repositories card.
Fill out the name of the repository and an optional description.
To get a copy of this repository on your local system, see the "Cloning a Repository" topic.

Create a repo using the Copia desktop app

When creating a repo with the Copia desktop app, you have two options:
  • Create a new repository
  • Add existing/local repository

Create New Repository

Creating a new repository will create a new empty local repository folder on your system. You can access this feature in three locations:
  1. 1.
    If you have no repositories already, you may be presented with an option to Create a New Repository on your hard drive...
  2. 2.
    You can select File -> New Repository...
  3. 3.
    If you have existing repositories, you can press the repository selector, and then press the Add button and choose Create New Repository...
After choosing one of the above options, you can define the Name, Description and Local path. Copia recommends that you always initialize the repository with a README. After checking the option, press Create Repository and your new repository folder will be created locally.

Add existing/local repository

To add an existing local folder or repository to Copia, you can look to one of the following options:
  • If you have no repositories already, you may be presented with an option to Add an Existing Repository from your hard drive...
  • You can select File -> Add local Repository...
  • If you have existing repositories, you can press the repository selector, and then press the Add button and choose Add Existing Repository...
After choosing on of the above options, you will be given the option to choose the Local path of the folder or existing repository.
If the folder is already a repository (i.e. perhaps it was copied from another system), then just click Add repository and you are done!
If the folder is NOT already a Git repository, Copia will ask if you would like to make it a repository. In this case, click Create a Repository to continue to set this folder up as a repository.
You will now be asked for the a repo name, description, and if you would like a README added to the folder (recommended as before). Enter this information and press the Create repository button.

Advanced Repo Settings

Wiki

If you choose to check the box and enable the repository wiki this will activate the wiki tab (next to the settings tab) available for all repositories on Copia. We recommend enabling wikis for all repositories. Wikis are powerful tools for asynchronous communication. A repository's wiki is a dedicated space for teams to store, find and share knowledge critical to that repository.
For example, at Copia we have an internal wiki for our documentation that provides guidelines on how to make changes and review changes before publishing. This allows all of our team members to make changes as needed while ensuring adherence to our specific style guidelines.
You then have the option to use Copia's wiki feature or to use an external wiki. To use an external wiki, enter the URL in the box provided.

Issue

If you choose to check the box and enable the repository issues this will activate the issues tab (next to the wiki tab) available for all repositories on Copia. If you decide to use the built-in issue tracker you also have the option to "enable dependencies for issues and pull requests." This option ties into branch protections by allowing you to prevent actions such as merging from being completed when an active issue exists.
You then have the option to use an external issue tracker. To use an external issue tracker, enter the URL in the box provided.

Danger Zone

Transfer ownership - Allows you to transfer this repository to another organization within Copia in which you have an admin or owner level account.
Delete Wiki Data - If for any reason you would like to delete the data from the Copia hosted wiki for the specific repository in question. Deleting a wiki is irreversible. If you want to store this content somewhere else, make sure to copy it before deleting.
Delete This Repository - Remember that these changes are irreversible. Only the selected repository will be deleted.
Archive This Repo - Once a project is complete you may want to archive it as to prevent any superfluous edits. You will still have access to it in read only form to reference as needed. This feature is reversible, you can un-archive the repo to restore its ability to receive commits and pushes, as well as new issues and pull-requests.
To find an archived repository, select the funnel symbol next to the search bar and check the archived box.

Voila!

You'll find yourself with an initialized repository. The location of your repository is always at https://app.copia.io/{your-username}/{your-repository} where {your-username} is the name you created at sign-up and {your-repository} is the name you created in the form above.