Skip to content

inguardians/peirates

Folders and files

NameName
Last commit message
Last commit date
Dec 23, 2022
May 17, 2023
Dec 23, 2022
May 17, 2023
May 17, 2023
May 17, 2023
May 17, 2023
Jul 8, 2023
May 15, 2024
May 17, 2023
Dec 22, 2022
Dec 22, 2022
May 17, 2023
Dec 23, 2022
Aug 13, 2020
Jul 8, 2023
Feb 28, 2024
Dec 23, 2022
May 22, 2024
May 14, 2024
Nov 5, 2023
Oct 15, 2024
Nov 5, 2023
Mar 17, 2025
Apr 30, 2024
May 14, 2024
Feb 21, 2024
Jul 5, 2024
Jul 8, 2023
May 14, 2024
May 22, 2024
Oct 15, 2024
Jun 24, 2024
Oct 15, 2024
May 1, 2024
Oct 15, 2024
Apr 30, 2024
Apr 30, 2024
May 16, 2024
May 16, 2024
May 14, 2024
May 22, 2024
Jul 8, 2024
May 22, 2024
May 22, 2024
Jul 5, 2024
May 22, 2024
May 22, 2024
Apr 30, 2024
Jan 15, 2023
May 30, 2024
Mar 17, 2025
Mar 6, 2019
Mar 6, 2019
Jan 15, 2023
May 22, 2024

Repository files navigation

Peirates

Release gosec

Logo

What is Peirates?

Peirates, a Kubernetes penetration tool, enables an attacker to escalate privilege and pivot through a Kubernetes cluster. It automates known techniques to steal and collect service account tokens, secrets, obtain further code execution, and gain control of the cluster.

Where do I run Peirates?

You run Peirates from a container running on Kubernetes or from a Kubernetes node, outside the container.

Does Peirates attack a Kubernetes cluster?

Yes, it absolutely does. Talk to your lawyer and the cluster owners before using this tool in a Kubernetes cluster.

Who creates Peirates?

InGuardians' CTO Jay Beale first conceived of Peirates and put together a group of InGuardians developers to create it with him, including Faith Alderson, Adam Crompton and Dave Mayer. Faith convinced us to all learn Golang, so she could implement the tool's use of the kubectl library from the Kubernetes project. Adam persuaded the group to use a highly-interactive user interface. Dave brought contagious enthusiasm. Together, these four developers implemented attacks and began releasing this tool that we use on our penetration tests.

Other contributors have helped as well - see GitHub to see more, but please also review credits.md.

Do you welcome contributions?

Yes, we absolutely do. Submit a pull request and/or reach out to peirates-dev@inguardians.com.

What license is this released under?

Peirates is released under the GPLv2 license.

Running Peirates

If you just want the peirates binary to start attacking things, grab the latest release from the releases page.

Peirates as a Container Image

You can find a useful alpine-peirates container image on Docker Hub, with a version number tag that tracks the Peirates version.

For example, for alpine-peirates:1.1.16, which contains peirates version 1.1.16, run:

docker pull bustakube/alpine-peirates:1.1.16

Building Peirates

However, if you want to build from source, read on!

Get peirates

go get -v "github.com/inguardians/peirates"

Get libary sources if you haven't already (Warning: this will take almost a gig of space because it needs the whole kubernetes repository)

go get -v "k8s.io/kubectl/pkg/cmd" "github.com/aws/aws-sdk-go"

Build the executable

cd $GOPATH/github.com/inguardians/peirates/scripts
./build.sh

This will generate an executable file named peirates in the same directory.