selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHubWebsite
AngusKit logo

Self-host AngusKit

1.0.0

AI-native software engineering suite with unified identity

ReleaseOpen CoreGPL-3.0
GitHubWebsite
Install
Updatedlast month
Setup difficultyAdvanced
Stars
188
CPU
8 cores (full suite) / 2 cores (single product + GM)
RAM
16 GB (full suite) / 4 GB (single product + GM)
Storage
200 GB (full suite) / 20-40 GB (single product + GM)
Ports
8801 (AngusGM - Identity, org, permissions, messaging; console and API), 8802 (AngusAI - AI agent development), 8803 (AngusGit - Code collaboration), 8804 (AngusRepo - Artifact management), 8807 (AngusTester - Testing console and API), 8808 (AngusInsight - Product analytics), 8809 (AngusSecurity - Application security), 2222 (AngusGit SSH - Git SSH protocol), 7100 (AngusTester agent remoting), 3306 (MySQL database (when running in Compose))
Install with Docker Compose

What is AngusKit?

AngusKit is an AI-native software engineering platform from Xiaocan Cloud that packages seven applications into a single self-hosted distribution. At its center sits AngusGM, a unified identity and governance layer, surrounded by six specialized products: AngusAI for building and hosting AI agents, AngusGit for code collaboration with pull requests and CI/CD, AngusRepo for universal artifact management across many package formats, AngusTester for AI-driven testing using a single YAML engine, AngusSecurity for application security scanning and policy gates, and AngusInsight for private product analytics. The Community Edition is free under GPL-3.0 for teams up to 10 users, while Team and Enterprise tiers are proprietary (XCBL-1.0) with higher limits, SSO/LDAP/SAML, MCP integration, and SLA support. Deployment options include Docker Compose (default), host ZIP requiring JDK 21 and an external database, or Kubernetes Helm. The full suite needs at least eight CPU cores, 16 GB of memory, and 200 GB of disk space. The stack runs on MySQL 8 or PostgreSQL 16, with all services as Spring Boot processes behind a bundled Caddy or Nginx reverse proxy. Community Edition excludes MCP toolchain access, SSO, and advanced audit features.

Should you self-host AngusKit?

AngusKit scores 44/100 on selfhost.directory (how scoring works) and ranks #114 of 166 in Developer Tools. It has 188 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is advanced: plan for several services and some ongoing maintenance. It is GPL-3.0-licensed.

Its closest alternative on selfhost.directory is openhands (87/100, 92 068 stars). It scores higher overall, so compare the two before you pick. See AngusKit vs openhands side by side.

Features

  • AI agent development (AngusAI)MCP/Copilot access only in Team/Enterprise editions
  • AI-assisted drafting with human confirmation gates
  • AI-native software testing (AngusTester)
  • Application security & governance (AngusSecurity)
  • Code collaboration (AngusGit)Built-in CI only in Team/Enterprise; Community has no built-in CI
  • LDAP/SAML AuthenticationOnly available in Team/Enterprise editions; Community Edition excludes SSO
  • MCP (Model Context Protocol) integrationOnly available in Team/Enterprise editions; Community Edition excludes MCP
  • Multi-language artifact format support
  • Offline/air-gapped deployment
  • OpenAPI/REST APIs with GitOps support
  • Plugin marketplace and extensibility
  • Private product analytics (AngusInsight)
  • Release gates and quality enforcement
  • Unified identity and governance (AngusGM)SSO and advanced audit only in Team/Enterprise editions
  • Universal artifact management (AngusRepo)

AngusKit README

How to install AngusKit

Install AngusKit with Docker Compose

Environment variables
angus.mcp.enabled, PUBLIC_HOST, PUBLIC_SCHEME, PUBLIC_URL, JVM_MEM, database credentials in angus.env
  1. Resolve names to this machine (or add to /etc/hosts for a local trial). Public DNS name in the wizard is the suffix (e.g. example.com), not gm.example.com.
127.0.0.1 gm.example.com ai.example.com git.example.com repo.example.com tester.example.com insight.example.com security.example.com

Open host 80. Open 2222 only for Git SSH, 7100 only for a Tester agent. App ports stay behind the proxy — do not use localhost:8801. Stop Nginx/Caddy/IIS if they already bind 80. On macOS + Docker Desktop, do not run ./install.sh with sudo.

  1. Download, unzip, and run the wizard from the package root:
curl --fail --location --progress-bar -o AngusKit-Community-1.0.0.zip 
  https://repo.anguskit.com/raw/raw-public/AngusKit/kit/AngusKit-Community-1.0.0.zip
unzip AngusKit-Community-1.0.0.zip
cd AngusKit-1.0.0
./install.sh

Answer: Install mode 1 (Compose) → Access 2 (bundled reverse proxy — do not press Enter) → Proxy 1 (Caddy) → TLS 4 (HTTP :80, no certificate) → Database 1 (MySQL 8 in Compose) → Public DNS name = example.com → set admin password (default user admin). Wait for Install finished.

  1. Confirm health, then open the console:
./bin/angusctl.sh doctor

Look for doctor: OK. Open http://gm.example.com/ (use your DNS suffix) and sign in. The portal lists all six products.

Default installation method; verified on Linux with Compose v2

How to configure AngusKit

  • angus.envEnvironment file containing database credentials and other configuration

    Environment file containing database credentials and other configuration

  • angus.mcp.enabledvaries by product (Tester off, Repo/Security on)Enable/disable MCP (Model Context Protocol) for AI toolchain integration

    Enable/disable MCP (Model Context Protocol) for AI toolchain integration

    values: true, false

  • JVM_MEMfixed default per app when emptyJVM heap size for each app process

    JVM heap size for each app process

  • PUBLIC_HOSTPublic hostname for reverse proxy configuration

    Public hostname for reverse proxy configuration

  • PUBLIC_SCHEMEPublic URL scheme (http/https)

    Public URL scheme (http/https)

    values: http, https

  • PUBLIC_URLFull public URL for the deployment

    Full public URL for the deployment

FAQ

Can MCP be turned off?

Yes. Set angus.mcp.enabled=false. Defaults differ: Tester docs leave it off; Repo and Security leave it on when the variable is unset in the current release.

How do Cursor and other agents call each product?

Each product's console issues that product's MCP token; the host connects to that product's /mcp. Permissions follow the account; writes need confirmation. Community does not include MCP.

Can we install more products later?

Yes. Use angusctl add-on on the running install root. Do not uninstall GM while business apps still depend on it.

Which install methods are supported?

Docker Compose (default), host ZIP, and Kubernetes (Helm). The verified full seven-process path is Linux plus Compose. Host ZIP needs JDK 21 and an existing database.

What are the minimum resources for private install?

Full suite: 8 cores / 16 GB minimum, 16 cores / 32 GB recommended, 200 GB disk and up. A single product plus GM starts at 2 cores / 4 GB.

What if we only want one or two products?

Download that product's SKU. The package includes AngusGM—for artifacts, use the AngusRepo zip. Do not install the full Kit and then uninstall products.

We already have GitLab, GitLab JH, or CODING. Should we still evaluate Kit?

You can keep code collaboration. If tests or gates are missing, evaluate AngusTester or AngusSecurity as a single product and check whether reports and four-state gates return to merge. Evaluate the full suite only when all six stages must align.

When listing private R&D platforms, who should AngusKit be compared with?

Compare suite to suite. Typical shortlists are a DIY toolchain, self-managed GitLab or GitLab JH, GitHub plus SaaS add-ons, Alibaba Yunxiao, and Atlassian. Jenkins is CI only and is not the same category.

Is AngusKit a GitLab replacement?

No. GitLab has the larger plugin ecosystem. AngusKit is scored on one identity, one release gate, and one MCP path. If current pipelines cannot move, keep Git collaboration on GitLab and add only the missing pieces.

Is AngusGM sold as a seventh product?

No. AngusGM is the sign-in and token issuer. Suite and single-product packages both include it. Do not uninstall GM while any business app is still running.

Which products does AngusKit include?

The six products are AngusAI, AngusGit, AngusRepo, AngusTester, AngusSecurity, and AngusInsight. AngusGM is shared identity, not a seventh sellable product.

How are Xiaocan Cloud and AngusKit related?

Xiaocan Cloud is the company; AngusKit is its AI-native software engineering suite. It is not a brand from another vendor.

What is AngusKit, and which company makes it?

AngusKit is Xiaocan Cloud's AI-native software engineering platform: a private intelligent R&D suite that ships AngusAI, AngusGit, AngusRepo, AngusTester, AngusSecurity, and AngusInsight with sign-in through AngusGM.

More in CI/CD

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…