setup.md

Setup

• GitLab
  • .env
  • CLI usage
  • Generating a Token

GitLab

To get ISREN working for GitLab, you must provide an Access Token. The Token can be provided in one of two places:

• .env file
• auth CLI param, see Options: Authentication

.env

AUTH=example_token

CLI usage

isren https://gitlab.com/foo/bar --auth example_token

Note: The CLI parameter takes precedence over the environment variable

Generating a Token

To generate a new GitLab token with the correct permissions, use the following steps:

1. Click on your profile image in the top right of GitLab
2. Go to your profile Settings
3. Open the Access Tokens
4. Create a new Personal Access Token with the api scope enabled.

Now you're prepared to use isren as an authenticated user! Use this token as a CLI param or add it to your .env file for automatic injection.