Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
This branch is 92 commits ahead, 714 commits behind Ne0nd0g:master.

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
March 31, 2021 17:08
November 13, 2022 11:41
March 7, 2021 17:24
December 26, 2022 07:53
January 17, 2022 10:30
March 31, 2021 17:08
March 31, 2021 17:08
October 24, 2021 19:40
April 4, 2021 16:59
January 17, 2022 10:30
December 26, 2022 07:50
March 31, 2021 17:08
November 21, 2022 16:59
November 21, 2022 17:20

License Python Downloads


Kubesploit is a cross-platform post-exploitation HTTP/2 Command & Control server and agent dedicated for containerized environments written in Golang and built on top of Merlin project by Russel Van Tuyl (@Ne0nd0g).

Our Motivation

While researching Docker and Kubernetes, we noticed that most of the tools available today are aimed at passive scanning for vulnerabilities in the cluster, and there is a lack of more complex attack vector coverage.
They might allow you to see the problem but not exploit it. It is important to run the exploit to simulate a real-world attack that will be used to determine corporate resilience across the network.
When running an exploit, it will practice the organization's cyber event management, which doesn't happen when scanning for cluster issues.
It can help the organization learn how to operate when real attacks happen, see if its other detection system works as expected and what changes should be made.
We wanted to create an offensive tool that will meet these requirements.

But we had another reason to create such a tool. We already had two open-source tools (KubiScan and kubeletctl) related to Kubernetes, and we had an idea for more. Instead of creating a project for each one, we thought it could be better to make a new tool that will centralize the new tools, and this is when Kubesploit was created.

We searched for an open-source that provide that heavy lifting for a cross-platform system, and we found Merlin, written by Russel Van Tuyl (@Ne0nd0g), to be suitable for us.

Our main goal is to contribute to raising awareness about the security of containerized environments, and improve the mitigations implemented in the various networks. All of this captured through a framework that provides the appropriate tools for the job of PT teams and Red Teamers during their activities in these environments. Using these tools will help you estimate these environments' strengths and make the required changes to protect them.

What's New

As the C&C and the agent infrastructure were done already by Merlin, we integrated Go interpreter ("Yaegi") to be able to run Golang code from the server to the agent.
It allowed us to write our modules in Golang, provide more flexibility on the modules, and dynamically load new modules. It is an ongoing project, and we are planning to add more modules related to Docker and Kubernetes in the future.

The currently available modules are:

  • Container breakout using mounting

  • Container breakout using docker.sock

  • Container breakout using CVE-2019-5736 exploit

  • Scan for Kubernetes cluster known CVEs

  • Port scanning with focus on Kubernetes services

  • Kubernetes service scan from within the container

  • Light kubeletctl containing the following options:

    • Scan for containers with RCE
    • Scan for Pods and containers
    • Scan for tokens from all available containers
    • Run command with multiple options
  • cGroup breakout

  • Kernel module breakout

  • Var log escape

  • Deepce: Docker enumeration (Open-Source project integrated as a module)

  • Vulnerability test: check which of kubesploit exploits your container is vulnerable to

    For detailed information about the modules, check the WiKi page

Quick Start

We created a dedicated Kubernetes environment in Katacoda for you to experiment with Kubesploit.
It’s a full simulation with a complete set of automated instructions on how to use Kubesploit. We encourage you to explore it.



To build this project, run the make command from the root folder.

NOTE: Currently you'll need to use Golang 1.18 or Go 1.19 (the latest 2 major releases) based on the golang requirements that traefik/yaegi v0.14.3 have.

Quick Build

To run quick build for Linux, you can run the following:

export PATH=$PATH:/usr/local/go/bin
go build -o agent cmd/merlinagent/main.go
go build -o server cmd/merlinserver/main.go


In order to run the server using a container, you have to make the Kubesploit server listen on the interface (and not You can update the interface field in the config.yaml.

sidenote: make sure to bind ports between the host and container (the default port is 443 and it can be configured in the config.yaml as well)


YARA rules

We created YARA rules that will help to catch Kubesploit binaries. The rules are written in the file kubesploit.yara.

Agent Recording

Every Go module loaded to the agent is being recorded inside the victim machine.


We created a MITRE map of the vectors attack being used by Kubesploit.

Mitigation for Modules

For every module we created, we wrote its description and how to defend from it.
We sum it up in the file.


We welcome contributions of all kinds to this repository.
For instructions on how to get started and descriptions of our development workflows, please see our contributing guide.


We want to thank Russel Van Tuyl (@Ne0nd0g) for creating Merlin as an open-source that allowed us to build Kubesploit on top of it.
We also want to thank Traefik Labs (@traefik) for creating Go interpreter ("Yaegi") that allowed us to run the Golang modules on a remote agent easily.


Copyright (c) 2021 CyberArk Software Ltd. All rights reserved.
This repository is licensed under GPL-3.0 License.
For the full license text see LICENSE.

Share Your Thoughts And Feedback

For more comments, suggestions or questions, you can contact Eviatar Gerzi (@g3rzi) from CyberArk Labs or open an issue. You can find more projects developed by us at


Kubesploit is a cross-platform post-exploitation HTTP/2 Command & Control server and agent written in Golang, focused on containerized environments.




Code of conduct





No packages published


  • Go 90.0%
  • Shell 5.6%
  • JavaScript 2.3%
  • Makefile 1.3%
  • HTML 0.4%
  • YARA 0.3%
  • Dockerfile 0.1%