Skip to content

README.md

Latest commit

 

History

History
76 lines (61 loc) · 2.93 KB

README.md

File metadata and controls

76 lines (61 loc) · 2.93 KB

Shows different variants of the logo in dark and light mode. Avocado C2

Avocado is a C2 framework currently in development. Expect bugs.

demo

Quick Start

Avocado currently only supports a Docker installation. You can run everything from your host; no need to attach into the container.

  1. Build and start the server
docker compose up -d --build server

The server listens for implants on port 31337 and for operators on 31338.

  1. Run the CLI operator (in a new terminal)
docker compose run --rm operator

The operator connects to the server automatically. No docker exec or shell inside the container.

  1. Generate an implant from the operator prompt
[Avocado] > generate <host:port> <linux|windows>

Example: generate 192.168.1.100:31337 linux. The built implant is written to the implant-out/ directory in the repo (mounted from the container).

To use a different output directory on your machine, run the operator with a bind mount:

docker compose run --rm -v /path/on/host:/home/avocado/implant-out -e IMPLANT_OUT_DIR=/home/avocado/implant-out operator

Alternative: plain Docker

Without compose, run the server with env vars so it doesn’t prompt:

docker build -t avocado .
docker run --rm -p 31337:31337 -p 31338:31338 \
  -e IMPLANT_LISTENER=0.0.0.0:31337 -e OPERATOR_LISTENER=0.0.0.0:31338 \
  --name avocado avocado

In another terminal, run the operator (set the server address to your host’s Docker IP or host.docker.internal:31338 if the operator runs on the host):

docker run --rm -it --add-host=host.docker.internal:host-gateway \
  -e OPERATOR_SERVER_ADDRESS=host.docker.internal:31338 \
  --name avocado-operator avocado operator

To get a shell inside the container: docker run --rm -it avocado bash.

GUI Operator

GUI Operator

Only manual installation is supported for the GUI operator. See operator README for more instructions.