README.md

Mythic

A cross-platform, post-exploit, red teaming framework built with GoLang, docker, docker-compose, and a web browser UI. It's designed to provide a collaborative and user friendly interface for operators, managers, and reporting throughout red teaming.

Starting Mythic

Mythic is controlled via the mythic-cli binary. To generate the binary, run sudo make from the main Mythic directory. From there, you can run sudo ./mythic-cli start to bring up all default Mythic containers.

More specific setup instructions, configurations, examples, screenshots, and more can be found on the Mythic Documentation website.

Installing Agents and C2 Profiles

The Mythic repository itself does not host any Payload Types or any C2 Profiles. Instead, Mythic provides a command, ./mythic-cli install github <url> [branch name] [-f], that can be used to install agents into a current Mythic instance.

Payload Types and C2 Profiles can be found on the overview page.

To install an agent, simply run the script and provide an argument of the path to the agent on GitHub:

sudo ./mythic-cli install github https://github.com/MythicAgents/apfell

The same is true for installing C2 Profiles:

sudo ./mythic-cli install github https://github.com/MythicC2Profiles/http

This allows the agents and c2 profiles to be updated at a much more regular pace and separates out the Mythic Core components from the rest of Mythic.

Updating

Use the ./mythic-cli update command to check for available updates across mythic-cli, mythic_server, and mythic_react's UI. This will NOT do the update for you, but let you know if an update exists. To check for updates against a specific branch, use ./mythic-cli update -b [branch name].

Mythic Docker Containers

Mythic uses Docker and Docker-compose for all of its components, which allows Mythic to provide a wide range of components and features without having requirements exist on the host. However, it can be helpful to have insight into how the containers are configured. All of Mythic's docker containers are hosted on DockerHub under itsafeaturemythic.

• mythic_go_base - Dockerfile
  • 
  • 
• mythic_go_dotnet - Dockerfile
  • 
  • 
• mythic_go_macos - Dockerfile
  • 
  • 
• mythic_python_base - Dockerfile
  • 
  • 
• mythic_python_dotnet - Dockerfile
  • 
  • 
• mythic_python_macos - Dockerfile
  • 
  • 
• mythic_python_go - Dockerfile
  • 
  • 

Additionally, Mythic uses a custom PyPi package (mythic_container) and a custom Golang package (https://github.com/MythicMeta/MythicContainer) to help control and sync information between all the containers as well as providing an easy way to script access to the server.

Dockerfiles for each of these Docker images can be found on MythicMeta.

mythic-container PyPi

The mythic-container PyPi package source code is available on MythicMeta and is automatically installed on all of the mythic_python_* Docker images.

This PyPi package is responsible for connecting to RabbitMQ, syncing your data to Mythic, and responding to things like Tasking, Webhooks, and configuration updates.

github.com/MythicMeta/MythicContainer

The github.com/MythicMeta/MythicContainer Golang package source code is available on MythicMeta.

This Golang package is responsible for connecting to RabbitMQ, syncing your data to Mythic, and responding to things like Tasking, Webhooks, and configuration updates.

Mythic Scripting

• Scripting source code (https://github.com/MythicMeta/Mythic_Scripting)

Documentation

All documentation for the Mythic project is being maintained on the docs.mythic-c2.net website.

Contributions

A bunch of people have suffered through bug reports, changes, and fixes to help make this project better. Thank you!

The following people have contributed a lot to the project. As you see their handles throughout the project on Payload Types and C2 Profiles, be sure to reach out to them for help and contributions:

• @djhohnstein
• @xorrior
• @Airzero24
• @SpecterOps

Liability

This is an open source project meant to be used with authorization to assess the security posture and for research purposes.

Historic References

• Check out a series of YouTube videos showing how Mythic looks/works and highlighting a few key features
• Check out the blog post on the rebranding.
• BSides Seattle 2019 Slides: Ready Player 2: Multiplayer Red Teaming against macOS
• BSides Seattle 2019 Demo Videos: Available on my Youtube
• Objective By the Sea 2019 talk on JXA: https://objectivebythesea.com/v2/talks/OBTS_v2_Thomas.pdf
• Objective By the sea 2019 Video: https://www.youtube.com/watch?v=E-QEsGsq3uI&list=PLliknDIoYszvTDaWyTh6SYiTccmwOsws8&index=17

File Icon Attribution

• bin/txt file icons - created by Icon home - Flaticon