GitLab Runner: 1. Authenticate

This documentation is part of the Automate with the CLI guide. You can view the complete guide here: Start GitLab-Runner, retrieve its credentials, and modify its configuration programmatically using the Stackhero CLI.

👋 Welcome to the Stackhero documentation!

Stackhero offers you an easy-to-use GitLab Runner cloud solution, designed to efficiently run your GitLab CI/CD jobs. Here’s what you can expect:

  • Unlimited CI/CD minutes: there’s no per-minute billing, so your pipelines can run whenever you need them.
  • Concurrent jobs: run multiple jobs in parallel to speed up your entire pipeline.
  • The Docker executor with Docker-in-Docker support: simplify building and pushing your container images.
  • Compatible with GitLab.com as well as any self-managed GitLab instance.
  • A private, dedicated VM powered by fast NVMe/SSD disks for consistent, reliable builds.
  • Available in both 🇪🇺 Europe and 🇺🇸 USA regions.

Save time: connect your first GitLab Runner and start running pipelines in just a few minutes!

The simplest way to get started is to log in through your browser. When you run the login command, the CLI opens a web page where you can approve access. No passwords or 2FA codes are entered directly into the CLI.

stackhero login

After logging in, your credentials are stored locally and will be used automatically by future CLI commands.

For fully automated environments such as scripts or CI pipelines, you may prefer a non-interactive access token. You can create one from your dashboard (Account > Access tokens), then export it as an environment variable. The CLI, as well as any script you run, will automatically detect it.

export STACKHERO_TOKEN="usr-xxxxxx:your-token"

Continue reading this guide

  1. Read the full guide: Automate with the CLI
    Start GitLab-Runner, retrieve its credentials, and modify its configuration programmatically using the Stackhero CLI
  2. 2. Find the GitLab-Runner service store
  3. 3. Choose an instance size and a region
  4. 4. Create the service
  5. 5. Retrieve credentials
  6. 6. Change the configuration

Other articles for GitLab Runner

  1. Getting started
    Connect your Stackhero GitLab Runner to GitLab.com or a self-hosted GitLab and run your first pipeline
  2. Building Docker images
    Build and push Docker images from your GitLab CI/CD pipelines using your Stackhero runner and Docker-in-Docker