# TeamCity Minimal Agent

TeamCity Minimal Agent is a self-hosted development app. The TeamCity Minimal Agent is a lightweight container image that runs build and test tasks for a JetBrains TeamCity server. It is open source and self-hosted, installable on Docker Hub.

Canonical page: https://ourlocalhost.com/app/5309/teamcity-minimal-agent

## Description

The TeamCity Minimal Agent is a lightweight container image that runs build and test tasks for a JetBrains TeamCity server. It ships only the essential tools an agent needs to check out code and execute build steps, so it starts quickly and uses fewer resources than full agent images. It suits teams that want a small, fast Docker build worker. Note that JetBrains has deprecated this image and no longer supports it; the repository README recommends the maintained teamcity-docker-images project instead.

## Platform availability

Available on 0 of 10 platforms.

## Health score

34/100 (Low), based on 5 of 5 factors.
- Maintained: 0 (last commit 1373 days ago)
- Popular: 28 (25 GitHub stars)
- Easy to install: 25 (0 install platforms, install notes, Docker image)
- Light to run: 95 (500 MB minimum RAM, runs on ARM)
- Security check: 75 (no serious findings)

## Links

- GitHub: https://github.com/JetBrains/teamcity-docker-minimal-agent
- Docker Hub: https://hub.docker.com/r/jetbrains/teamcity-minimal-agent

## Common questions

### How can I customize the teamcity-minimal-agent Docker image for my own agent?

You can log into the running container, make the needed changes, commit the container to a new image, and update the environment variables in the agent config folder.

### Why does a TeamCity Docker agent sometimes appear as a new unique build agent every time it runs?

This is an agent identity or naming issue: the containerized agent can be treated as a new, unique build agent on each start.

### Why does a build command work locally but fail on the TeamCity agent?

Make sure the command works on the agent machine under the same user and environment as the TeamCity agent; if necessary, run the agent under a different user or tweak its environment.

### Can TeamCity runs be isolated by using containers?

Yes, one option is to run builds in containers. TeamCity can also be configured to set an image.

## Alternatives

- Azure DevOps: Continuous Delivery Services for teams to share code, track work, and ship software – for any language, all in a single package.
- CircleCI: CircleCI provides development teams the confidence to build, test, and deploy—quickly and consistently—across numerous platforms.
- Codeship: Codeship is a hosted Continuous Delivery Service that integrates with GitHub and Bitbucket.
- Jenkins: Jenkins is a fork of Hudson and is a continuous build system for software projects.
- Octopus Deploy: Octopus Deploy is a user-friendly release management system for professional .NET developers.
- gocd: GoCD is an open-source continuous delivery server that automates and visualizes build, test, and release workflows for software teams.
- teamcity: TeamCity is JetBrains' server-based continuous integration and continuous delivery (CI/CD) system for building, testing, and deploying soft…

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