Tower Icon

Adding your first repository

Before you can start working with commits, branches, files, etc. you must add a Git repository you would like to work with to Tower's Dashboard.

Adding a repository to Tower

  1. Open Tower's Dashboard view.
    You can do so by selecting "Open Dashboard" from the "View" main menu.

  2. Depending on whether you already have an existing repository you want to add or not...

    • To add a repository that already exists on your disk, click the "Add Local Repository" button. From the dialog choose the path to your local repository and confirm.

    • To clone an existing repository that is located somewhere on the internet or on your network, click the "Clone Remote Repository" button. Enter the URL of the remote repository.
      Note: if you are using SSH Public Key for authentication, please leave the password field empty. Also note that a lot of hosting services (like Beanstalk or GitHub) require you to use a standard username (not your account user name!). See their help documentation for more on this topic.

    • To create an empty repository on your disk, click the "Create Local Repository" button.

  3. After having completed the following dialog you will see your repository added to the list. Double click it to open it for working.

With your first repository added to Tower and opened for working you can start browsing files, viewing history, and more.

NOTE:For detailed instructions on how to set up a private remote server for hosting your repository, please see the free eBook "ProGit" by Scott Chacon.


Related Topics

Managing Repositories

Adding a repository

Publishing a local repository on a remote server

A basic workflow with Tower