Installation

The source code of AdaptixС2 is available on github. The main branch is a stable version and does not contain the latest changes.

git clone https://github.com/Adaptix-Framework/AdaptixC2.git
cd AdaptixC2

Preinstall

To build extenders you need updated Mingw. Advice on building server and extenders (tested): using Ubuntu 24, Debian 12, or Dockerfile.

Auto

For Linux, you can use a specially prepared script that will install and configure the necessary packages for both the server and client parts. (pre_install_linux_all.sh)

Manual

To build Server and Extenders, you need to install additional dependencies. Please note that golang 1.25.4 is required to compile and run AdaptixServer (and special patched golang for win7 gopher agent).

Linux Debian

sudo apt install mingw-w64 make gcc g++ g++-mingw-w64

wget https://go.dev/dl/go1.25.4.linux-amd64.tar.gz -O /tmp/go1.25.4.linux-amd64.tar.gz
sudo rm -rf /usr/local/go /usr/local/bin/go
sudo tar -C /usr/local -xzf /tmp/go1.25.4.linux-amd64.tar.gz
sudo ln -s /usr/local/go/bin/go /usr/local/bin/go

# for windows 7 support by gopher agent
git clone https://github.com/Adaptix-Framework/go-win7 /tmp/go-win7
sudo mv /tmp/go-win7 /usr/lib/

Linux Arch

To build Client, you need to install additional dependencies

Linux Debian

sudo apt install gcc g++ build-essential make cmake mingw-w64 g++-mingw-w64 libssl-dev qt6-base-dev qt6-base-private-dev libxkbcommon-dev qt6-websockets-dev qt6-declarative-dev

Linux Arch

MacOS

Windows

Makefile

Server

AdaptixServer and Extenders (goplugins) must be built with the same version of the golang package.

make server-ext

All compiled files will be located in the dist directory.

Client

Linux / MacOS

The AdaptixClient is compiled from the cmake configuration.

make client

For fast builds in multithreaded mode, use make client-fast.

AdaptixClient file will be located in the dist directory.

Windows

Download QT online installer from the official website: https://www.qt.io/download-qt-installer-oss.

After launching the installer, on the package download page, check the boxes as shown in the screenshot below.

In QT Creator, select Open Project, select the CMakeLists.txt file and click on Configure Project.

After Configuration the project, change the build type to Release and build the project.

Create a directory for the client where all dependencies will be copied. Move the AdapticClient.exe executable to this directory, open cmd.exe and run windeployqt.exe.

The directory with the application and dependencies can be transferred to any computer.

Docker Compose

Profile	Description	Command
build-server	Build server only	docker compose --profile build-server up
build-extenders	Build extenders only	docker compose --profile build-extenders up
build-server-ext	Build server and extenders together	docker compose --profile build-server-ext up
runtime	Server runtime container	docker compose --profile runtime up -d

Added Docker cleanup targets for better build artifact management:

• docker-clean: Remove Docker containers and images (builders only)

  • Removes containers and images for build-server, build-extenders, and build-server-ext profiles

  • Preserves runtime container

• docker-clean-all: Remove all Docker artifacts (containers, images, volumes, networks)

  • Removes all build profiles including runtime

  • Cleans build output directories (AdaptixServer/server-dist)

  • Complete cleanup for fresh rebuilds