Authenticating repository access

How to authenticate access to your app repository

For repositories hosted in GitHub, Bitbucket or GitLab, the default authentication method is OAuth when you select one of these options.

If you choose to specify your app repo manually, you will need to configure an appropriate authentication method.

Authentication options

The following authentication methods are available:

Accessing other private private repositories (Git submodules or dependencies)

If your build needs to access other private repositories, such as Git submodules and/or dependencies, Nevercode can access, fetch and clone them only when you've set up proper SSH key authentication. See SSH key authentication for details.

Public repository

If you have a public repository stored in GitHub, Bitbucket or any other Git server, you should select Public repository as the authentication type.

  1. Enter the URL of the repository to the Checkout URL field. Follow the guidelines for defining checkout URL.
  2. Select Public repository as the authentication method.
  3. Click Save and continue to trigger fetching the branches from your repository.

SSH key authentication

Use SSH key authentication when your repository has private sub-modules that Nevercode needs to access to build your app.

To enable authentication using SSH key:

  1. Generate a key pair.
  2. Add the public key to your Git repository. Note that if there are private sub-modules in your project, you must add the keys to all the sub-modules that you need for building your app in Nevercode. Otherwise Nevercode cannot fetch and clone them.

On Nevercode:

  1. Enter the URL of the repository to the Checkout URL field. Follow the guidelines for defining checkout URL.
  2. Select SSH Key as the authentication method.
  3. Either drag and drop the private key to the SSH key field or click Select/drop file here to upload the file from your drive. Nevercode will check if the key is protected and will ask you for the passphrase.
  4. Enter the password to the input field under SSH key field.
  5. Click Save and continue to trigger fetching the branches from your repository.

Username and password authentication

Select this option if you have a password protected repository, or in other words, if you are using basic auth to protect your Git repository.

  1. Enter the URL of the repository to the Checkout URL field. Follow the guidelines for defining checkout URL.
  2. Select Username and password as the authentication method.
  3. Enter the username and password to the corresponding fields.
  4. Click Save and continue to trigger fetching the branches from your repository.

OAuth authentication

Authentication via OAuth is used by default when you select GitHub, Bitbucket or GitLab as the repository host for your app.

  1. Depending on where your repository is hosted, click Github via OAuth, Bitbucket via OAuth or GitLab via OAuth.
  2. If you haven't logged in to your repository, you will be prompted to do so.
  3. Authorize access to your repository. After that you will be redirected back to Nevercode and the list of repositories connected to your GitHub/Bitbucket/GitLab account will be displayed.

Note that if you try to connect with Github, Bitbucket or GitLab, and see an error about failing to load projects, it might be that the access token is expired. Navigate to Settings > Integrations and reconnect your account.