Creating a new repository

You can create a new repository on your personal account or any organization where you have sufficient permissions.

Tip: Owners can restrict repository creation permissions in an organization. For more information, see "Restricting repository creation in your organization."

  1. In the upper-right corner of any page, use the drop-down menu, and select New repository.

    Drop-down with option to create a new repository

  2. Optionally, to create a repository with the directory structure and files of an existing repository, use the Choose a template drop-down and select a template repository. You'll see template repositories that are owned by you and organizations you're a member of or that you've used before. For more information, see "Creating a repository from a template."

    Template drop-down menu

  3. Use the Owner drop-down menu, and select the account you want to own the repository.

    Owner drop-down menu

  4. Type a name for your repository, and an optional description.

    Create repository field

  5. Choose to make the repository either public or private. Public repositories are visible to the public, while private repositories are only accessible to you, and people you share them with. For more information, see "Setting repository visibility."

    Radio buttons to select private or public status

  6. If you're not using a template, there are a number of optional items you can pre-populate your repository with. If you're importing an existing repository to GitHub, don't choose any of these options, as you may introduce a merge conflict. You can add or create new files using the user interface or choose to add new files using the command line later. For more information, see "Importing a Git repository using the command line," "Adding a file to a repository using the command line," and "Addressing merge conflicts."

    • You can create a README, which is a document describing your project. For more information, see "About READMEs."
    • You can create a .gitignore file, which is a set of ignore rules. For more information, see "Ignoring files."
    • You can choose to add a software license for your project. For more information, see "Licensing a repository."
  7. Optionally, if the personal account or organization in which you're creating uses any GitHub Apps from GitHub Marketplace, select any apps you'd like to use in the repository.

    List of your account's GitHub Apps from GitHub Marketplace and option to grant access

  8. Click Create repository.

  9. At the bottom of the resulting Quick Setup page, under "Import code from an old repository", you can choose to import a project to your new repository. To do so, click Import code.

Further reading

Ask a human

Can't find what you're looking for?

Contact us