Havoc/teamserver

Havoc Teamserver

Source code of Havoc teamserver. Written in Golang.

Build the Teamserver

• Pre-requisites
  1. Go1.18
• Native
  • To build the Teamserver client locally, run the following command in this folder(~/Havoc/Teamserver/):
    1. make
  • That's it! If it ran successfully to completion, you should now have a compiled binary ready for use in the /bin folder.
  • Example use with a prewritten profile: sudo ./teamserver server --profile profiles/havoc.yaotl --verbose
  • Example use with default profile: sudo ./teamserver --default --verbose
• Docker
  • To build the Teamserver client using a local Docker container, run the following commands(assuming you have Docker installed):
    1. Build the Dockerfile:
       • sudo docker build -t havoc-teamserver -f Teamserver-Dockerfile .
    2. (Optional) Create a persistent data volume for the container:
       • sudo docker volume create havoc-c2-data
    3. Run the container:
       • sudo docker run -it -d -v havoc-c2-data:/data havoc-teamserver
• Jenkins Docker
  • We can also build the Teamserver binary using a pre-configured Jenkins Docker image.
    1. From the parent folder(Havoc), run the following command to build the container:
       • `sudo docker build -t jenkins-havoc-teamserver -f JT-Dockerfile .``
    2. (Optionally) Create a persistent data volume for the container:
       • sudo docker volume create havoc-cicd-c2-data
    3. Next, we want to run the container:
       • sudo docker run -p8080:8080 -it -d -v havoc-cicd-c2-data:/data jenkins-havoc-teamserver
    4. We can now visit Jenkins at localhost:8080 and create a Pipeline to build the Havoc Teamserver!
       • For a pre-done Groovy script, please see the Havoc-Teamserver.groovy in the Assets folder.

Run the Teamserver

• Base:
  • The teamserver can also be used directly:
    • ./teamserver -h
    • ./teamserver server --profile profiles/havoc.yaotl -v
    • ./teamserver server --default -v
• Docker
  • We can run the teamserver completely from within a container!
  1. Build the container:
     • sudo docker build -f Client-Dockerfile .
  2. Launch the container (be sure to change the port mapping to match your environment):
     • sudo docker run -p40056:40056 -p 443:443 -it -d -v havoc-c2-data:/data jenkins-havoc-client
  3. Access the teamserver at localhost:40056 using your Teamserver client.