Git Service Accounts
Nova supports signing in to Git service accounts. This enables you to authenticate with remote Git services, such as GitHub, GitLab, Bitbucket, and Gitea. Once authenticated, you can clone, pull from, and push to repositories hosted on these services.
To start, head to Nova’s Settings > Git Accounts.
Adding a Git Account
Click the + button in the bottom-left corner of the account list to add an account. You’ll be asked to choose which service you want to authenticate.
|
Currently, Nova supports the following services:
|
|
Authentication Methods
Depending on which service you select, there will be different options for authenticating your account.
- Personal Access Token
- A token you can generate to authenticate your service account. These tokens often have restricted access to your account, to ensure apps that you provide tokens can only take actions you’ve granted them permission to take. When using a personal access token with Nova, you’ll need to ensure your token has full access to your repositories so that you can clone and push to your private repositories.
- OAuth Token
- For services that support OAuth, simply enter your account name in Nova and click Sign In. You’ll be directed to the service’s website and asked to authorize Nova to access your account.
- Basic Auth
- A standard account name and password combination.
The table below illustrates which services support which authentication methods.
| Service | Access Tokens | OAuth | Basic Auth |
|---|---|---|---|
| GitHub | ✓ | ✓ | No |
| GitHub Enterprise | ✓ | No | No |
| GitLab.com | ✓ | No | No |
| GitLab (self-hosted) | ✓ | No | No |
| Gitea | ✓ | No | ✓ |
| Bitbucket Cloud | No | ✓ | ✓ |
| Bitbucket Server | ✓ | No | ✓ |
For services that are self-hosted, such as GitHub Enterprise, GitLab, Gitea, and Bitbucket Server, you will also need to provide the URL of the server you will be authenticating with.
Account Settings
Once you’ve added an account, it will appear listed on the left side of the Git Accounts settings pane. Simply select an account to change its settings. You can also click the minus (–) icon in the bottom-left to delete the selected account.
- Description
- Set a display name for the account. Useful if you have multiple accounts with the same service.
- Clone Using
- Choose whether to prefer HTTPS or SSH when cloning repositories with this account.
- SSH Key
- Manually specify a key to use when accessing repositories with this account using SSH. If this key is not set or does not authenticate, other options from your on-disk SSH configuration may be attempted.
|
Next → Cloning a Repository |