references/container-syncing.md

GitHub

Container Syncing

This page describes how Mythic containers register and synchronize their definitions.

Source: https://docs.mythic-c2.net/customizing/payload-type-development/payload-type-info/container-syncing

What Is Syncing

When a container starts, it connects to RabbitMQ and sends a JSON representation of everything about the payload type:

  • Payload type metadata (name, OS, parameters, etc.)
  • All command definitions and their parameters
  • Build parameters
  • Browser scripts
  • Everything needed for Mythic to present the agent in the UI

When Does Syncing Happen

Container startup

When a payload container starts, it immediately sends its sync data to Mythic.

New container detected

If Mythic receives a connection from a container it doesn't recognize, it requests a sync.

C2 profile sync cascade

When a C2 profile syncs, it triggers a re-sync of ALL payload type containers. This is because a payload type might declare support for a C2 profile that hasn't started yet. When that C2 profile comes online, all payload types need to re-register so the UI properly shows the supported C2 options.

Wrapper sync cascade

When a wrapper payload type syncs, it triggers a re-sync of all non-wrapper payload types. A payload type might support a wrapper that hasn't started yet, so when the wrapper comes online, everything re-syncs.

Development Implications

  • Changes to command definitions, parameters, or agent metadata take effect after container restart
  • For Python containers: sudo ./mythic-cli start [agent_name] restarts and triggers re-sync
  • For Go containers: rebuild first (make build), then restart
  • Syncing is automatic - no manual registration needed
  • The UI updates immediately after a successful sync

Checking Sync Status

  • Container appears in the Mythic UI under Payload Types
  • Check container logs: sudo ./mythic-cli logs [agent_name]
  • If sync fails, errors appear in the event feed

Version Tracking

Latest container/PyPi versions are tracked on the Mythic GitHub README: https://github.com/its-a-feature/Mythic