# Gitlab Agent

Gitlab Agent is a local Node.js CLI and library for developers that securely stores GitLab personal access tokens and authenticates with private GitLab npm repositories.

Canonical page: https://ourlocalhost.com/app/4744/gitlab-agent

## Description

Gitlab Agent is a local Node.js CLI and library for developers that securely stores GitLab personal access tokens and authenticates with private GitLab npm repositories.

## Platform availability

Available on 1 of 10 platforms: Helm.

## Health score

6/100 (Low), based on 3 of 4 factors.
- Maintained: 0 (last commit 884 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 25 (1 install platform, install notes)

## Links

- GitHub: https://github.com/JoelVenable/gitlab-agent

## Common questions

### Which version of the GitLab agent for Kubernetes should I install in my cluster?

The agent installed in your cluster should match the GitLab major and minor version. GitLab may warn you on the agent's list page that the installed agent version should be updated.

### How long should I wait if an older agent version is still cached by KAS?

Wait at least 20 minutes. KAS periodically deletes outdated agent versions, and the agent and GitLab need time to reconcile.

### When can GRPC:unimplemented occur while registering a GitLab agent?

It was reported when self-hosted GitLab/KAS was behind an SSL-terminating load balancer. The error appeared while trying to register an agent in a project.

### What should I check if the agent pod fails to register in a Docker Compose setup with Nginx?

Check the GitLab server logs and the GitLab and Nginx configuration. In a reported Docker Compose setup using Nginx as a reverse proxy, GitLab server logs helped identify the issue.

---
Source: Our Local Host (https://ourlocalhost.com/app/4744/gitlab-agent), the self-hosted and open-source app directory.
