No entries match these filters. Clear filters
Malcolm adds normalized ECS ECS Elastic Common Schema, an open specification maintained by Elastic that defines a standard field naming convention for log and event data, letting cyber tools share and correlate records without per-source field mapping. threat intelligence fields, expanded OT OT Operational Technology: hardware and software that monitors or controls physical industrial processes, such as power grids, pipelines, and manufacturing equipment, making it a distinct target environment from standard IT networks. protocol field mapping, Community ID Community ID A vendor-neutral network flow hashing standard, maintained by Corelight, that produces a consistent identifier for a connection across different tools so analysts can correlate events from disparate data sources. computation in Logstash, and richer document-lookup API arguments︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ GET THIS VERSION
copy
$ git clone --branch v26.10.0 https://github.com/cisagov/Malcolm.git
$ git checkout v26.10.0
└──▷ USE IT
Enable Community ID computation for Zeek logs that arrive in Malcolm without one, so correlation across tools works even when Zeek did not tag the flow.
env
copy
LOGSTASH_ZEEK_COMPUTE_COMMUNITY_ID=true
Run Modbus on a nonstandard port (502 is occupied; site uses 5020) so Malcolm parses it without a custom Zeek script.
env
copy
ZEEK_PORTS_MODBUS=5020/tcp
Add optional Community ID computation in Logstash for Zeek logs that arrive without one, controlled by the LOGSTASH_ZEEK_COMPUTE_COMMUNITY_ID environment variable (enabled by default); an ID Zeek already supplied is never overwritten, and transport is inferred by log type for single-transport analyzers.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Extend the Malcolm API's document lookup with sort, offset, and track_total_hits arguments and a total hit count with its exact-or-lower-bound relation; both the document lookup and field aggregations endpoints now return shards and timed_out status so a client can distinguish a partial or timed-out search from a genuinely empty result. Argument validation errors return HTTP 400 with an error string, and setting MALCOLM_API_DEBUG=true logs a compact per-request search summary. Not checked yet Add ZEEK_PORTS_… environment variables to register non-default ports for thirteen ICSNPP OT protocol analyzers (BACnet BACnet A communication protocol for building automation systems, standardized as ASHRAE 135, covering HVAC, lighting, and access control devices. Cyber tools use it to discover and interact with building infrastructure on IP or serial networks. , C12.22, EtherNet/IP, GE-SRTP, Genisys, HART-IP, Modbus, Omron FINS, OPC UA Binary, Profinet IO-CM, ROC+, S7comm, and Synchrophasor), so a site running these protocols on nonstandard ports no longer needs a custom Zeek script. Not checked yet Add ioc_types and include_autogenerated_tags parameters for Google Threat Intelligence collections, so a deployment can load only the indicator types it needs and omit machine-generated tags, reducing memory cost in Zeek. Not checked yet Add NETBOX_DEVICETYPE_IMPORT_VENDORS to limit the NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. device-type library import to selected manufacturers on first import, also constraining which manufacturers are matched during MAC OUI enrichment. Not checked yet
+5 more
show less
Expand threat intelligence enrichment into normalized ECS threat.* fields across every source: Zeek intel kill chain phases map to threat.tactic.*, MISP 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. galaxy tags in cif_tags map to threat.technique.* and threat.technique.subtechnique.*, Mandiant and Google Threat Intelligence actors map to threat.group.name, and Suricata Emerging Threats mitre_* metadata and capa subtechnique results are mapped the same way, with 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. for ICS ICS Industrial Control Systems — hardware and software that monitor and control physical processes like power grids, pipelines, and manufacturing lines, making them a target for cyber tools focused on operational technology environments. distinguished from Enterprise; additionally, per-indicator metadata is carried into Zeek intel including Mandiant categories, campaigns, reports, opt-in threat rating (meta.threat_score), and STIX 2.1 STIX 2.1 A JSON-based open standard maintained by OASIS for representing threat intelligence objects and relationships, letting cyber tools exchange indicators, actors, and TTPs in a common machine-readable format. confidence values, with Mandiant's M-Score treated as confidence and absent values left unset. Not checked yet Update Zeek to 9.0.1 LTS, parsing and indexing two new log types: multicast_participants.log (surfaced in a new Multicast dashboard) and ntp_control.log and ntp_private.log (added to the index template and Arkime field definitions). Not checked yet Normalize Zeek OT protocol fields to Arkime field names for BACnet, C12.22, DNP3 DNP3 A serial and TCP/IP communication protocol used in industrial control systems, especially power grids and water utilities, to let control software poll and command field devices like sensors and switches. , EtherNet/IP (ENIP/CIP), Modbus, OPC UA, S7comm, and Synchrophasor so filters and drill-downs carry across Dashboards and Arkime; original zeek.* fields are preserved alongside the new top-level fields. Not checked yet Add two Zeek detections authored by Corelight: php2shell-detect for the php2shell vulnerabilities and emudhra-weak-keys for weak eMudhra certificate keys. Not checked yet Prompt during Hedgehog Linux ISO ISO A widely adopted international standards body that publishes technical specifications; cyber tools cite ISO standards to signal compliance with recognized benchmarks for quality, security, or interoperability. installation whether to run the sensor status kiosk at startup (defaulting to yes), with no disabling kiosk.service and removing the browser autostart entry. Not checked yet
Add optional Community ID computation in Logstash for Zeek logs that arrive without one, controlled by the LOGSTASH_ZEEK_COMPUTE_COMMUNITY_ID environment variable (enabled by default); an ID Zeek already supplied is never overwritten, and transport is inferred by log type for single-transport analyzers.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Update Zeek to 9.0.1 LTS, parsing and indexing two new log types: multicast_participants.log (surfaced in a new Multicast dashboard) and ntp_control.log and ntp_private.log (added to the index template and Arkime field definitions). Not checked yet Add two Zeek detections authored by Corelight: php2shell-detect for the php2shell vulnerabilities and emudhra-weak-keys for weak eMudhra certificate keys. Not checked yet
7 more in Everything
└──▷ BREAKING ON UPGRADE
!
The environment variables `ZEEK_SYNCHROPHASOR_PORTS`, `ZEEK_GENISYS_PORTS`, and `ZEEK_ENIP_PORTS` are renamed to `ZEEK_PORTS_SYNCHROPHASOR`, `ZEEK_PORTS_GENISYS`, and `ZEEK_PORTS_ENIP`; existing values are migrated on upgrade, but any external automation referencing the old names must be updated.
Our best guess
Malcolm v26.09.0 adds compressed-PCAP PCAP A packet capture, recorded network packets that can be inspected later. Analysts use it to reconstruct communication and investigate protocol behavior or suspicious traffic. uploads, configurable Suricata rule schedules, OTKB enrichment, and a configurable default dashboard.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ GET THIS VERSION
copy
$ git clone --branch v26.09.0 https://github.com/cisagov/Malcolm.git
$ git checkout v26.09.0
└──▷ USE IT
Schedule Suricata rule updates to run nightly at 02:00 and also pull updates once at container startup, with a commercial ET/Pro source enabled.
config/suricata.env
copy
SURICATA_UPDATE_CRON_EXPRESSION='0 2 * * *'
SURICATA_UPDATE_RULES=true
SURICATA_UPDATE_ENABLE_SOURCES='et/pro secret=<your-oinkcode>'
SURICATA_UPDATE_SOURCES=true
Pin the Malcolm landing page to the ICS ICS Industrial Control Systems — hardware and software that monitor and control physical processes like power grids, pipelines, and manufacturing lines, making them a target for cyber tools focused on operational technology environments. /IoT IoT A collective label for internet-connected physical devices — sensors, cameras, routers, appliances — that tools target because they run embedded firmware with limited patching and broad network exposure. Security Overview dashboard for OT-focused deployments.
config/dashboards-helper.env
copy
OPENSEARCH_DEFAULT_DASHBOARD=ICS/IoT Security Overview
Allow NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. autopopulation to enrich events from a known public sensor subnet in addition to RFC-1918 space.
config/netbox.env
copy
NETBOX_AUTO_POPULATE_SUBNETS='203.0.113.0/24'
Adds SURICATA_UPDATE_CRON_EXPRESSION to make the Suricata rule-update schedule configurable, SURICATA_UPDATE_RULES=true to trigger a rule update at container startup, SURICATA_UPDATE_ENABLE_SOURCES to enable indexed suricata-update sources (e.g., et/pro) with optional parameters, and SURICATA_UPDATE_SOURCES to expose the source-index refresh toggle — all in config/suricata.env.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds OPENSEARCH_DEFAULT_DASHBOARD to the dashboards-helper.env configuration template, letting operators pin the landing dashboard to one of four named options: Overview, Security Overview, ICS/IoT Security Overview, or Severity. Not checked yet Adds NETBOX_AUTO_POPULATE_SUBNETS to allow NetBox autopopulation to include explicitly listed public IP subnets (private-only remains the default when the variable is blank). Not checked yet Adds support for uploading raw gzip-, bzip2-, xz-, and lzma-compressed PCAP/PCAPNG files; the upload watcher decompresses the stream with libmagic and routes recognized PCAP content to the PCAP processing directory, while non-PCAP compressed streams and tar archives continue through the existing path. Not checked yet Adds an optional early integration with 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. 's Operational Technology Knowledge Base (OTKB), enriching supported Zeek and Wireshark OT events with normalized protocol, function, classification, citation, procedure, asset, campaign, software, and 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. for ICS context under a new otkb.* field hierarchy, including an OpenSearch OpenSearch An open-source search and analytics engine, forked from Elasticsearch by AWS in 2021, that lets cyber tools store, query, and visualize large volumes of log or event data without licensing restrictions. composable template, an OT Knowledge Base dashboard, and support for connected, air-gapped, and file-seeded-then-API-refreshed deployments. Not checked yet
+1 more
show less
Improves NetBox IP enrichment to prefer the most specific (longest-prefix-match) prefix, preventing parent and child prefixes from both being applied and producing multi-valued source.segment/destination.segment fields. Not checked yet
Adds SURICATA_UPDATE_CRON_EXPRESSION to make the Suricata rule-update schedule configurable, SURICATA_UPDATE_RULES=true to trigger a rule update at container startup, SURICATA_UPDATE_ENABLE_SOURCES to enable indexed suricata-update sources (e.g., et/pro) with optional parameters, and SURICATA_UPDATE_SOURCES to expose the source-index refresh toggle — all in config/suricata.env.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds OPENSEARCH_DEFAULT_DASHBOARD to the dashboards-helper.env configuration template, letting operators pin the landing dashboard to one of four named options: Overview, Security Overview, ICS/IoT Security Overview, or Severity. Not checked yet Adds NETBOX_AUTO_POPULATE_SUBNETS to allow NetBox autopopulation to include explicitly listed public IP subnets (private-only remains the default when the variable is blank). Not checked yet Adds support for uploading raw gzip-, bzip2-, xz-, and lzma-compressed PCAP/PCAPNG files; the upload watcher decompresses the stream with libmagic and routes recognized PCAP content to the PCAP processing directory, while non-PCAP compressed streams and tar archives continue through the existing path. Not checked yet Adds an optional early integration with 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. 's Operational Technology Knowledge Base (OTKB), enriching supported Zeek and Wireshark OT events with normalized protocol, function, classification, citation, procedure, asset, campaign, software, and 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. for ICS context under a new otkb.* field hierarchy, including an OpenSearch OpenSearch An open-source search and analytics engine, forked from Elasticsearch by AWS in 2021, that lets cyber tools store, query, and visualize large volumes of log or event data without licensing restrictions. composable template, an OT Knowledge Base dashboard, and support for connected, air-gapped, and file-seeded-then-API-refreshed deployments. Not checked yet
1 more in Everything
advisory CVE-2026-107362
Sep 30, 2026
·
issue 128
CVE-2026-107362: SSRF SSRF Server-side request forgery, an attack that tricks a server into making requests chosen by an attacker. Those requests can reach internal services the attacker cannot access directly. with full response-body readback via the FilePond fetch API in the file-upload component (CVSS CVSS Common Vulnerability Scoring System, a method for describing a vulnerability's characteristics and severity. Its score is not the probability that attackers will exploit it. 7.1, affects <= 26.08.0)︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet
advisory CVE-2026-107333
Sep 30, 2026
·
issue 128
CVE-2026-107333: Authorization bypass: an unresolved /./ segment defeats every nginx RBAC RBAC Role-based access control, where permissions are assigned to roles such as reader or administrator and users receive those roles. It makes access easier to manage than individual permission lists. role restriction (CVSS CVSS Common Vulnerability Scoring System, a method for describing a vulnerability's characteristics and severity. Its score is not the probability that attackers will exploit it. 8.1, affects <= v26.08.0)︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet
Malcolm v26.08.0 adds ICS ICS Industrial Control Systems — hardware and software that monitor and control physical processes like power grids, pipelines, and manufacturing lines, making them a target for cyber tools focused on operational technology environments. /OT purdue_zone enrichment, Raspberry Pi 5 support, configurable Strelka/Suricata lists, and new env vars for Zeek ZAM and OpenSearch OpenSearch An open-source search and analytics engine, forked from Elasticsearch by AWS in 2021, that lets cyber tools store, query, and visualize large volumes of log or event data without licensing restrictions. multi-source.
└──▷ GET THIS VERSION
copy
$ git clone --branch v26.08.0 https://github.com/cisagov/Malcolm.git
$ git checkout v26.08.0
└──▷ USE IT
Enable the Zeek ZAM script optimizer to reduce scripting overhead during high-volume live capture or large PCAP PCAP A packet capture, recorded network packets that can be inspected later. Analysts use it to reconstruct communication and investigate protocol behavior or suspicious traffic. reprocessing runs.
Run Strelka with Malcolm's default scanner list plus ScanStrings to extract embedded strings from files during upload analysis.
env
copy
STRELKA_SCANNERS=default,ScanStrings
Let one Malcolm Dashboards instance query multiple separate Malcolm OpenSearch backends simultaneously for cross-deployment analysis.
env
copy
DASHBOARDS_DATA_SOURCES_ENABLED=true
Adds STRELKA_SCANNERS environment variable to select individual Strelka scanners, accepting the keyword default (Malcolm's built-in list) alone or combined with explicit scanner names such as default,ScanStrings. Not checked yet Adds ZEEK_ZAM environment variable to enable Zeek's ZAM script optimizer (-O ZAM) for both live capture and offline PCAP processing. Not checked yet Adds DASHBOARDS_DATA_SOURCES_ENABLED environment variable to enable OpenSearch Dashboards' multiple data sources feature, letting one Dashboards instance query several separate Malcolm OpenSearch backends at once. Not checked yet Adds NGINX_CSP_FORM_ACTION_EXTRA environment variable to allow additional cross-origin form submission targets in nginx's Content-Security-Policy, supporting authentication flows such as SAML SAML A standard for passing signed identity assertions between a sign-in provider and an application. It lets a user sign in through their organization's identity provider. HTTP-POST binding. Not checked yet Adds a purdue_zone NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. custom field for devices, virtual machines, and IP prefixes, enriching ICS/OT security-zone classifications (e.g., IT, OT, DMZ) into source/destination/related fields in Arkime, with automatic propagation from containing prefixes to autopopulated devices and VMs. Not checked yet
+3 more
show less
Adds a new Biomes OpenSearch Dashboard that visualizes connections between purdue_zone security zones. Not checked yet Adds a configuration-tool option to populate Suricata's disable.conf with a comma-separated list of rule SIDs, letting users disable noisy or irrelevant detection rules without editing rule files directly. Not checked yet Adds Raspberry Pi 5 support to the Hedgehog Linux build. Not checked yet
8 details in Everything
└──▷ BREAKING ON UPGRADE
! FoxIO ja4+ Zeek plugin updated to v1.0.0 (see FoxIO-LLC/ja4#313); the release notes flag this under Breaking changes , indicating existing ja4+ field output or plugin behavior may change on upgrade.
advisory CVE-2026-107361
Aug 24, 2026
·
issue 128
CVE-2026-107361: Missing Server-to-Server (s2s) Authentication Configuration on Hedgehog Sensor Arkime Reachback Port (CVSS CVSS Common Vulnerability Scoring System, a method for describing a vulnerability's characteristics and severity. Its score is not the probability that attackers will exploit it. 4.2, affects <= v26.07.1)︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet
advisory CVE-2026-107337
Aug 24, 2026
·
issue 128
CVE-2026-107337: Unauthenticated script execution via CSRF CSRF Cross-site request forgery, an attack that makes a signed-in browser send an unwanted request to a site. The site may accept the request using the victim's existing session. in kiosk /script_call endpoint (CVSS CVSS Common Vulnerability Scoring System, a method for describing a vulnerability's characteristics and severity. Its score is not the probability that attackers will exploit it. 7.1, affects <= v26.07.1)︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet
advisory CVE-2026-107336
Aug 20, 2026
·
issue 128
CVE-2026-107336: Unauthenticated bypass of the nginx auth gate on the /iddash2ark/ Arkime shortcut (regex case-sensitivity mismatch + forwarded-identity confused deputy) (CVSS CVSS Common Vulnerability Scoring System, a method for describing a vulnerability's characteristics and severity. Its score is not the probability that attackers will exploit it. 6.5, affects = v26.07.1 (current CalVer line; also present in nginx_readonly.conf — note: pre-CalVer v6.4.3 is NOT affected) )︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet
advisory CVE-2026-107334
Jul 28, 2026
·
issue 128
CVE-2026-107334: Percent-Encoded Request Paths Bypass Malcolm's nginx RBAC RBAC Role-based access control, where permissions are assigned to roles such as reader or administrator and users receive those roles. It makes access easier to manage than individual permission lists. (CVSS CVSS Common Vulnerability Scoring System, a method for describing a vulnerability's characteristics and severity. Its score is not the probability that attackers will exploit it. 5.4, affects <= v26.07.1)︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet
advisory CVE-2026-107335
Jul 28, 2026
·
issue 128
CVE-2026-107335: Raw-stream and Lzip Uploads Bypass Malcolm's Archive-Bomb Protections (CVSS CVSS Common Vulnerability Scoring System, a method for describing a vulnerability's characteristics and severity. Its score is not the probability that attackers will exploit it. 6.5, affects <= v26.07.1)︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet
Malcolm v26.07.1 adds IEC 104 protocol support, flexible NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. enrichment datasets, and archive extraction resource limits.
└──▷ GET THIS VERSION
copy
$ git clone --branch v26.07.1 https://github.com/cisagov/Malcolm.git
$ git checkout v26.07.1
└──▷ USE IT
Disable IEC 104 protocol analysis in Zeek when your environment does not include IEC 104 traffic and you want to reduce processing overhead.
ini
copy
ZEEK_DISABLE_ICS_IEC104=true
Restrict archive extraction during Zeek log upload to prevent resource exhaustion from deeply nested or oversized archives.
ini
copy
SAFE_EXTRACT_MAX_ENTRIES=2000
SAFE_EXTRACT_MAX_DEPTH=10
SAFE_EXTRACT_MAX_BYTES=1073741824
Enable NetBox enrichment for both standard and ICS ICS Industrial Control Systems — hardware and software that monitor and control physical processes like power grids, pipelines, and manufacturing lines, making them a target for cyber tools focused on operational technology environments. /OT datasets so that industrial device context is applied alongside default enrichment.
ini
copy
LOGSTASH_NETBOX_ENRICHMENT_DATASETS=default,ics
Adds ZEEK_DISABLE_ICS_IEC104 in zeek.env to control whether the IEC 60870-5-104 (IEC 104) Zeek plugin (spicy-iec104 by CERT.LV) is disabled, with full Zeek log ingestion, ECS ECS Elastic Common Schema, an open specification maintained by Elastic that defines a standard field naming convention for log and event data, letting cyber tools share and correlate records without per-source field mapping. field mapping, Arkime fields, and a new IEC 104 OpenSearch OpenSearch An open-source search and analytics engine, forked from Elasticsearch by AWS in 2021, that lets cyber tools store, query, and visualize large volumes of log or event data without licensing restrictions. Dashboards dashboard. Not checked yet Adds SAFE_EXTRACT_MAX_ENTRIES, SAFE_EXTRACT_MAX_DEPTH, and SAFE_EXTRACT_MAX_BYTES in upload-common.env to set archive extraction resource limits for uploaded archive files, with defaults of 5,000 entries, 20 directory levels, and 4 GiB of expanded data. Not checked yet Expands LOGSTASH_NETBOX_ENRICHMENT_DATASETS in logstash.env to accept default, ics/ot, all, explicit provider.dataset values, or comma-separated combinations (e.g., default,ics), defaulting to default. Not checked yet Exposes LOGSTASH_NETBOX_ENRICHMENT_DATASETS as configurable checkboxes in the configuration TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. . Not checked yet Improves ./scripts/start error messages by listing the specific missing or invalid authentication-related files instead of a generic failure message. Not checked yet
+1 more
show less
Enables system-quickstart to detect and prepopulate existing time synchronization settings when rerun. Not checked yet
6 details in Everything
advisory CVE-2026-63133
Jul 15, 2026
·
issue 128
CVE-2026-63133: Uncontrolled Resource Consumption in Archive Extraction (Inode-Exhaustion DoS) (CVSS CVSS Common Vulnerability Scoring System, a method for describing a vulnerability's characteristics and severity. Its score is not the probability that attackers will exploit it. 6.5, affects <= v26.06.1)︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet
advisory CVE-2026-63134
Jul 15, 2026
·
issue 128
CVE-2026-63134: Path Traversal in Archive Extraction Allows Arbitrary Directory Creation (CVSS CVSS Common Vulnerability Scoring System, a method for describing a vulnerability's characteristics and severity. Its score is not the probability that attackers will exploit it. 5.4, affects <= v26.06.1)︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet
Malcolm v26.06.1 requires MAXMIND_GEOIP_DB_ACCOUNT_ID alongside the license key for MMDB MMDB A binary database file format designed for fast IP-address lookups, maintained by MaxMind, used by cyber tools to resolve IPs to geolocation or ASN data without external API calls. downloads and hardens the file-upload surface.
└──▷ GET THIS VERSION
copy
$ git clone --branch v26.06.1 https://github.com/cisagov/Malcolm.git
$ git checkout v26.06.1
└──▷ USE IT
Supply the now-required MaxMind account ID alongside the license key so Malcolm can download GeoLite MMDB files during startup.
ini
copy
MAXMIND_GEOIP_DB_ACCOUNT_ID=123456
MAXMIND_GEOIP_DB_LICENSE_KEY=your_license_key_here
Adds MAXMIND_GEOIP_DB_ACCOUNT_ID as a required field alongside MAXMIND_GEOIP_DB_LICENSE_KEY in ./config/arkime-secret.env for downloading MaxMind MMDB files at build and runtime. Not checked yet Adds tag_on_exception to all ruby Logstash filters to surface parsing exceptions during debugging. Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! MAXMIND_GEOIP_DB_ACCOUNT_ID is now required in ./config/arkime-secret.env; existing setups that only set MAXMIND_GEOIP_DB_LICENSE_KEY will fail to download MMDB files at build and runtime until the account ID is added.! PostgreSQL databases for NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. and Keycloak are not compatible between v26.06.0 and v26.06.1; upgrading without first backing up the NetBox database (and not using keycloak as the auth method) will leave those databases in a broken state.! curl (via php-curl) has been removed from the htadmin container, causing its container health check to report unhealthy.
Malcolm v26.06.0 hardens security across 15 vulnerabilities and requires mandatory secrets for Arkime and NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. on upgrade.
└──▷ GET THIS VERSION
copy
$ git clone --branch v26.06.0 https://github.com/cisagov/Malcolm.git
$ git checkout v26.06.0
└──▷ TRY IT
Run the mandatory pre-upgrade settings migration so Malcolm can rewrite changed environment variables before you start services.
copy
$ ./scripts/status && ./scripts/configure && ./scripts/start
Adds KEYCLOAK_SSL_VERIFY (default false) to keycloak.env to control Keycloak OIDC OIDC OpenID Connect, a sign-in protocol built on OAuth 2.0. An application uses identity information from a trusted provider instead of maintaining a separate password for each user. SSL SSL A cryptographic protocol for encrypting network connections, now deprecated in favor of TLS but whose name persists colloquially. Cyber tools reference it when handling HTTPS or other encrypted-channel inspection and termination. verification. Not checked yet ARKIME_PASSWORD_SECRET in arkime-secret.env no longer ships with a default value and must be explicitly set during auth_setup. Not checked yet SUPERUSER_PASSWORD in netbox-secret.env no longer ships with a default value and must be explicitly set during auth_setup. Not checked yet Adds Content-Security-Policy framing headers (frame-ancestors, base-uri, form-action) and X-Frame-Options: SAMEORIGIN globally to harden against clickjacking. Not checked yet Closes RBAC RBAC Role-based access control, where permissions are assigned to roles such as reader or administrator and users receive those roles. It makes access easier to manage than individual permission lists. fail-open for unlisted handlers: Malcolm API's defaultdict(lambda: True) no longer grants access to unregistered routes by default. Not checked yet
+3 more
show less
Closes read-only deployment bypass: POST /mapi/event is now blocked in read-only mode. Not checked yet Closes read-only Arkime bypass: deny-regex now includes addtags and removetags endpoints. Not checked yet Closes WISE auth bypass: authentication path can no longer be selected by a client-supplied User-Agent . Not checked yet
8 details in Everything
└──▷ BREAKING ON UPGRADE
! ARKIME_PASSWORD_SECRET in arkime-secret.env no longer has a default value; existing deployments must set it explicitly during auth_setup or Malcolm will fail to start.! SUPERUSER_PASSWORD in netbox-secret.env no longer has a default value; existing deployments must set it explicitly during auth_setup or Malcolm will fail to start.! Upgrading from an existing Malcolm installation requires running ./scripts/status before ./scripts/configure, ./scripts/start, or other control scripts to migrate settings via ./config/env-var-actions.yml.
Malcolm v26.05.2 adds a File Tree dashboard, Suricata OT detections for D-Link HNAP abuse, and alerting webhook improvements.
└──▷ GET THIS VERSION
copy
$ git clone --branch v26.05.2 https://github.com/cisagov/Malcolm.git
$ git checkout v26.05.2
└──▷ TRY IT
Migrate Malcolm settings before starting the upgraded instance — required when upgrading from any prior installation.
copy
$ ./scripts/status && ./scripts/start
Adds the File Tree visualization dashboard, presenting a hierarchical breakdown of files observed in network traffic — including nested archived files such as ZIP files and tarballs — with parent/child relationship exploration. Not checked yet Improves the alerting loopback webhook API endpoint. Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! Upgrading from an existing Malcolm installation requires running ./scripts/status before ./scripts/configure, ./scripts/start, or other Malcolm control scripts to migrate settings.! NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. is upgraded to v4.5.x (a major release, up from v4.4.10); backing up your NetBox database before upgrading is strongly recommended.
Malcolm v26.05.0 adds file.strings extraction, configurable Zeek timeouts and cluster backends, and NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. custom script auto-registration.
└──▷ GET THIS VERSION
copy
$ git clone --branch v26.05.0 https://github.com/cisagov/Malcolm.git
$ git checkout v26.05.0
└──▷ USE IT
Tune Zeek file analysis to abandon stalled files faster in high-throughput capture environments.
ini
copy
# in ./config/zeek.env
ZEEK_FILE_ANALYZER_TIMEOUT_SEC=3
Switch the Zeek cluster to use ZeroMQ ZeroMQ A messaging library that provides socket-like abstractions for async message passing over TCP, IPC, or in-process transports, letting tools wire together distributed components without a dedicated message broker. as the backend transport instead of the default Broker.
ini
copy
# in ./config/zeek.env
ZEEK_CLUSTER_BACKEND=ZeroMQ
Adds ZEEK_FILE_ANALYZER_TIMEOUT_SEC (default 5) to zeek.env to control how long a file can be inactive before Zeek file analysis discards its internal state. Not checked yet Adds ZEEK_CLUSTER_BACKEND to zeek.env to select the Zeek cluster backend (ZeroMQ or Broker ). Not checked yet Adds file.strings extraction, indexing, and search support across the Strelka → Logstash → OpenSearch OpenSearch An open-source search and analytics engine, forked from Elasticsearch by AWS in 2021, that lets cyber tools store, query, and visualize large volumes of log or event data without licensing restrictions. (wildcard field mapping) → Arkime/WISE pipeline. Not checked yet Adds NetBox custom script support via bind-mounting ./netbox/custom-scripts, with automatic script registration at container startup. Not checked yet Expands malcolm_appliance_packager.sh to package images for both Malcolm and Hedgehog profiles in a single tarball. Not checked yet
+3 more
show less
Allows netdev users in ISO ISO A widely adopted international standards body that publishes technical specifications; cyber tools cite ISO standards to signal compliance with recognized benchmarks for quality, security, or interoperability. -installed environments to configure network interfaces using nmcli and nmtui. Not checked yet Reworks NetBox preloaded device roles into a hierarchical taxonomy. Not checked yet Switches Kubernetes ingress from ingress-nginx (EOL) to Traefik, with a new RKE2/Traefik-based Vagrant environment replacing the old example. Not checked yet
8 details in Everything
└──▷ BREAKING ON UPGRADE
! NetBox startup/control scripts are renamed from netbox/scripts to netbox/control-scripts; any references to the old path will break.! Run ./scripts/status before ./scripts/configure or ./scripts/start to migrate environment variable settings per ./config/env-var-actions.yml; skipping this step may leave the installation in a broken state.
Malcolm v26.04.1 adds Strelka scanner controls, nested archive scanning, and new env-var config keys in pipeline.env and zeek.env.
└──▷ GET THIS VERSION
copy
$ git clone --branch v26.04.1 https://github.com/cisagov/Malcolm.git
$ git checkout v26.04.1
└──▷ USE IT
Enable only specific Strelka scanners (e.g., YARA and PE analysis) to reduce noise or resource use from unwanted file-scan modules.
ini
copy
# In ./config/pipeline.env
STRELKA_SCANNERS=ScanYara,ScanPe
Allow Strelka to scan files nested inside ZIP archives captured in network traffic (opt in by setting the flag to false).
ini
copy
# In ./config/zeek.env
ZEEK_DISABLE_SPICY_ZIP=false
Revert Arkime PCAP PCAP A packet capture, recorded network packets that can be inspected later. Analysts use it to reconstruct communication and investigate protocol behavior or suspicious traffic. processing to libpcap mode if the faster scheme-based processing causes compatibility issues with your capture files.
ini
copy
# In ./config/arkime.env
ARKIME_PCAP_LIBPCAP=true
Adds STRELKA_SCANNERS to pipeline.env to enable or disable individual Strelka file scanners without rebuilding. Not checked yet Adds ZEEK_DISABLE_SPICY_ZIP to zeek.env (default true) to control nested file scanning from ZIP archives via Strelka. Not checked yet Adds ARKIME_PCAP_LIBPCAP to arkime.env (default false) to revert Arkime PCAP file processing to older libpcap mode instead of the faster scheme processing. Not checked yet Indexes selected Strelka result fields into Malcolm's data store for querying file-scan outcomes alongside network traffic. Not checked yet Supports nested file scanning (e.g., files inside ZIP archives) handled by Strelka. Not checked yet
+1 more
show less
Updates Zeek to v8.1.1 and Arkime to v6.1.1. Not checked yet
6 details in Everything
└──▷ BREAKING ON UPGRADE
! FILEBEAT_SCANNER_FINGERPRINT_LENGTH default in filescan.env changed from 1024 to 512; installations relying on the old default fingerprint length will behave differently after upgrade.! redis.env has been renamed to valkey.env and its variables have been renamed accordingly; any custom configuration or scripts referencing redis.env variable names will break until updated. Run ./scripts/status before running ./scripts/configure or ./scripts/start to migrate settings automatically via ./config/env-var-actions.yml.
Malcolm v26.04.0 adds Strelka scanner toggle, nested archive file scanning, and new env-var controls in pipeline and zeek configs.
└──▷ GET THIS VERSION
copy
$ git clone --branch v26.04.0 https://github.com/cisagov/Malcolm.git
$ git checkout v26.04.0
└──▷ USE IT
Disable a specific Strelka scanner (e.g., the YARA scanner) without touching pipeline code, by setting STRELKA_SCANNERS in pipeline.env.
ini
copy
STRELKA_SCANNERS=ScanPe,ScanHash,ScanEntropy
Enable nested ZIP archive scanning by Strelka — set ZEEK_DISABLE_SPICY_ZIP to false so Zeek's Spicy ZIP parser hands off archive contents for deep file inspection.
ini
copy
ZEEK_DISABLE_SPICY_ZIP=false
Revert Arkime to legacy libpcap PCAP PCAP A packet capture, recorded network packets that can be inspected later. Analysts use it to reconstruct communication and investigate protocol behavior or suspicious traffic. processing mode when the faster scheme processing causes compatibility issues in your environment.
ini
copy
ARKIME_PCAP_LIBPCAP=true
Adds STRELKA_SCANNERS to pipeline.env to enable or disable individual Strelka scanners without editing pipeline code. Not checked yet Adds ZEEK_DISABLE_SPICY_ZIP to zeek.env (default true) to control nested file scanning from ZIP archives via Strelka. Not checked yet Adds ARKIME_PCAP_LIBPCAP to arkime.env (default false) to revert Arkime PCAP processing to legacy libpcap mode instead of the faster scheme processing. Not checked yet Indexes selected Strelka result fields into the Malcolm data store for querying file-scan metadata alongside network traffic. Not checked yet Supports nested/archived file scanning (e.g., files inside ZIPs) through Strelka integration. Not checked yet
+3 more
show less
Changes default of FILEBEAT_SCANNER_FINGERPRINT_LENGTH in filescan.env from 1024 to 512. Not checked yet Updates Zeek to v8.1.1, bringing Zeek 8.1 capabilities into Malcolm's traffic analysis pipeline. Not checked yet Updates ICSNPP Hart IP parser for improved ICS ICS Industrial Control Systems — hardware and software that monitor and control physical processes like power grids, pipelines, and manufacturing lines, making them a target for cyber tools focused on operational technology environments. /OT protocol analysis. Not checked yet
8 details in Everything
└──▷ BREAKING ON UPGRADE
! redis.env is renamed to valkey.env and its variables are renamed accordingly — any references to the old filename or variable names in scripts or external config will break.! The default of FILEBEAT_SCANNER_FINGERPRINT_LENGTH in filescan.env changes from 1024 to 512, which may alter file fingerprinting behavior for existing file-scanning pipelines.
Malcolm v26.02.0 adds SURICATA_DISABLE_SIDS, skip-threat-intel flags for Zeek, and Redis tuning env vars.
└──▷ GET THIS VERSION
copy
$ git clone --branch v26.02.0 https://github.com/cisagov/Malcolm.git
$ git checkout v26.02.0
└──▷ USE IT
Silence specific high-volume Suricata rule IDs (e.g. SID 2200074 and 2200075) so they never generate alerts, without touching rule files.
ini
copy
# in ./config/suricata.env
SURICATA_DISABLE_SIDS=2200074,2200075
Skip threat-intel enrichment when processing uploaded PCAP PCAP A packet capture, recorded network packets that can be inspected later. Analysts use it to reconstruct communication and investigate protocol behavior or suspicious traffic. files offline, to speed up bulk re-analysis without false positives from stale intel feeds.
ini
copy
# in ./config/zeek-offline.env
ZEEK_DISABLE_INTEL_OFFLINE=true
Cap Redis memory and set an eviction policy to prevent the cache container from consuming unbounded memory in long-running deployments.
ini
copy
# in ./config/redis.env
REDIS_MAXMEMORY=512mb
REDIS_MAXMEMORY_POLICY=allkeys-lru
REDIS_CACHE_MAXMEMORY=256mb
REDIS_CACHE_MAXMEMORY_POLICY=allkeys-lru
REDIS_AUTO_AOF_REWRITE_MIN_SIZE=64mb
Adds SURICATA_DISABLE_SIDS to suricata.env to suppress noisy Suricata rule IDs without editing rule files. Not checked yet Adds ZEEK_DISABLE_INTEL_LIVE to zeek-live.env and ZEEK_DISABLE_INTEL_OFFLINE to zeek-offline.env so offline PCAP processing (and live capture) can skip threat-intel lookups independently. Not checked yet Adds REDIS_MAXMEMORY, REDIS_MAXMEMORY_POLICY, REDIS_AUTO_AOF_REWRITE_MIN_SIZE, REDIS_CACHE_MAXMEMORY, and REDIS_CACHE_MAXMEMORY_POLICY to redis.env for fine-grained tuning of the redis and redis-cache containers. Not checked yet Adds the indices:admin/create permission to the capture_service OpenSearch OpenSearch An open-source search and analytics engine, forked from Elasticsearch by AWS in 2021, that lets cyber tools store, query, and visualize large volumes of log or event data without licensing restrictions. role. Not checked yet
4 details in Everything
Malcolm v26.01.0 replaces its file scanning framework with Strelka, adds JA4D log parsing, fuzzy hashing, and major Logstash pipeline performance improvements.
└──▷ GET THIS VERSION
copy
$ git clone --branch v26.01.0 https://github.com/cisagov/Malcolm.git
$ git checkout v26.01.0
└──▷ USE IT
Tune the maximum search result window for large network dataset queries without hitting the default 10 000 document cap.
ini
copy
# In ./config/opensearch.env
MALCOLM_INDEX_MAX_RESULT_WINDOW=50000
Switch FileBeat to fingerprint-based file identity so renamed or rotated log files are not re-ingested from the start.
ini
copy
# In ./config/filebeat.env
FILEBEAT_WATCHER_POLLING=false
FILEBEAT_SCANNER_FINGERPRINT_OFFSET=0
FILEBEAT_SCANNER_FINGERPRINT_LENGTH=1024
Adds filescan.env, filescan-secret.env, and pipeline.env config files, plus variables in redis.env, to configure the new Strelka-based file scanning backend — replacing the previous EXTRACTED_FILE_ENABLE_CAPA, EXTRACTED_FILE_ENABLE_CLAMAV, and EXTRACTED_FILE_ENABLE_YARA env vars. Not checked yet Adds FILEBEAT_SCANNER_FINGERPRINT_OFFSET and FILEBEAT_SCANNER_FINGERPRINT_LENGTH in filebeat.env to customize FileBeat filestream file identity and scanner fingerprint; FILEBEAT_WATCHER_POLLING now controls native- vs. fingerprint-based file identification. Not checked yet Adds MALCOLM_INDEX_MAX_RESULT_WINDOW in opensearch.env to override index.max_result_window (default 10000) for searches of network and other data indexes. Not checked yet Replaces the file scanning framework with Strelka, a real-time, container-based file scanning system for threat hunting, threat detection, and incident response, providing more features and improved extensibility. Not checked yet Enables fuzzy hashing (SSDeep, TLSH) in addition to 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. for all Zeek-scanned files. Not checked yet
+6 more
show less
Adds additional health check data (Redis, etc.) to the /mapi/ready API. Not checked yet Enables parsing of JA4D log generated by Zeek alongside dhcp.log. Not checked yet Enables MAC addresses MAC addresses A hardware-address identifier used on a local network, such as Ethernet or Wi-Fi. It identifies a network interface for delivery on that link, rather than routing across the internet. in Suricata events. Not checked yet Updates default NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. -enriched datasets (LOGSTASH_NETBOX_ENRICHMENT_DATASETS in logstash.env) to include filescan.strelka alongside existing Zeek and Suricata datasets. Not checked yet Delivers major Logstash parse pipeline performance improvements: replaced the cidr filter with a custom Ruby filter, changed broadcast-and-drop communication to targeted messaging, and reworked the compact event filter to remove empty/null values before indexing. Not checked yet Improves the IP Connections Tree dashboard. Not checked yet
11 details in Everything
└──▷ BREAKING ON UPGRADE
! The VTOT_API2_KEY environment variable for submitting extracted file SHA sums to VirusTotal is no longer used; use the Google Threat Intelligence service or another supported intelligence feed instead.! Adding a new log source parsing pipeline to Logstash no longer uses LOGSTASH_PARSE_PIPELINE_ADDRESSES; a mapping file is now required instead.! EXTRACTED_FILE_ENABLE_CAPA, EXTRACTED_FILE_ENABLE_CLAMAV, and EXTRACTED_FILE_ENABLE_YARA are no longer used; scanners are now configured via the Strelka backend config file.! The quarantine/ and preserved/ subdirectories are no longer used in the Extracted Files web interface; files are browsed and downloaded from the Files or File Scanning dashboards in OpenSearch OpenSearch An open-source search and analytics engine, forked from Elasticsearch by AWS in 2021, that lets cyber tools store, query, and visualize large volumes of log or event data without licensing restrictions. Dashboards.! Malcolm's Zeek container image now places Zeek-related files under /usr/local/zeek instead of /opt/zeek; update any custom volume mounts or references to /opt/zeek.! zeek-secret.env has been removed; its values are now in filescan-secret.env.
Malcolm v25.12.1 adds a Hedgehog run-profile label to the installer splash screen alongside component version bumps.
└──▷ GET THIS VERSION
copy
$ git clone --branch v25.12.1 https://github.com/cisagov/Malcolm.git
$ git checkout v25.12.1
Installer splash screen now displays HEDGEHOG when Malcolm is launched using the Hedgehog run profile, making the active profile visually identifiable at startup. Not checked yet
1 detail in Everything
Malcolm v25.12.0 unifies Hedgehog Linux and Malcolm ISO ISO A widely adopted international standards body that publishes technical specifications; cyber tools cite ISO standards to signal compliance with recognized benchmarks for quality, security, or interoperability. platforms, adds SMILE analytics visualizations, and expands NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. lateral-movement enrichment.
└──▷ GET THIS VERSION
copy
$ git clone --branch v25.12.0 https://github.com/cisagov/Malcolm.git
$ git checkout v25.12.0
└──▷ USE IT
Set the Malcolm base URL so a remote Kibana instance can resolve extracted file download links and other absolute-path assets.
ini
copy
MALCOLM_URL=https://malcolm.home.arpa
Adds MALCOLM_URL to dashboards-helper.env to set the base URL of the Malcolm instance, enabling remote Kibana instances to resolve absolute paths for extracted file downloads and other Malcolm-hosted assets. Not checked yet Moves ARKIME_EXPOSE_WISE_GUI and ARKIME_ALLOW_WISE_GUI_CONFIG from arkime.env to arkime-offline.env, and changes the default value of ARKIME_EXPOSE_WISE_GUI from false to true. Not checked yet Expands the default LOGSTASH_NETBOX_ENRICHMENT_DATASETS in logstash.env to include additional protocol types (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. , 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. , SSH, and others) to improve lateral-movement tracking enrichments. Not checked yet Unifies Hedgehog Linux and Malcolm ISO into a single containerized build workflow using the existing Hedgehog run-profile, eliminating duplicated system-process architecture for Arkime, Zeek, and Suricata. Not checked yet Switches Hedgehog Linux network interface configuration from the legacy configure-interfaces script to NetworkManager; new installations will not automatically request IP addresses via DHCP. Not checked yet
+2 more
show less
Adds four new SMILE analytics visualizations: BACnet BACnet A communication protocol for building automation systems, standardized as ASHRAE 135, covering HVAC, lighting, and access control devices. Cyber tools use it to discover and interact with building infrastructure on IP or serial networks. Trends, DNP3 DNP3 A serial and TCP/IP communication protocol used in industrial control systems, especially power grids and water utilities, to let control software poll and command field devices like sensors and switches. Trends, Modbus Trends, RDP Connections Tree, and SSH Connections Tree. Not checked yet Updates the existing Connections Tree SMILE visualization. Not checked yet
7 details in Everything
└──▷ BREAKING ON UPGRADE
! ARKIME_EXPOSE_WISE_GUI and ARKIME_ALLOW_WISE_GUI_CONFIG are moved from arkime.env to arkime-offline.env; any manual configuration of these variables in arkime.env will no longer take effect.! The default value of ARKIME_EXPOSE_WISE_GUI changes from false to true; deployments that relied on the WISE GUI GUI A graphical user interface, controls such as windows, buttons and menus. It lets people use software visually rather than entering commands. being hidden by default must now explicitly set it to false in arkime-offline.env.! There is no upgrade path from previous Hedgehog Linux installations to the new containerized platform; existing sensors must be reimaged, with /opt/sensor/sensor_ctl/control_vars.conf and other relevant data backed up beforehand.! New Malcolm and Hedgehog Linux installations configured via NetworkManager will not automatically request IP addresses using DHCP.! The deprecated ./scripts/legacy_install.py installer script has been removed; users must use install.py instead.! The osd_transform_vis plugin is removed from Dashboards; visualizations built with it will no longer render on Elastic/Kibana-based Malcolm installations.
Malcolm v25.11.0 overhauls install.py with a menu-based UI, adds a Connections Tree lateral-movement visualization, and bundles the OpenSearch OpenSearch An open-source search and analytics engine, forked from Elasticsearch by AWS in 2021, that lets cyber tools store, query, and visualize large volumes of log or event data without licensing restrictions. repository-s3 plugin.
└──▷ GET THIS VERSION
copy
$ git clone --branch v25.11.0 https://github.com/cisagov/Malcolm.git
$ git checkout v25.11.0
└──▷ TRY IT
Fall back to the legacy wizard-style configuration if the new menu-based interface causes issues.
copy
$ scripts/legacy_install.py --configure
Enable OpenSearch snapshots to an S3-compatible S3-compatible An object-storage API that mirrors Amazon S3's HTTP interface, so any client or cyber tool written for AWS S3 works unchanged against any compliant storage backend. bucket by setting the resolver correctly after the env-var rename.
ini
copy
NGINX_RESOLVER_IPV4=true
NGINX_RESOLVER_IPV6=false
Adds NGINX_RESOLVER_IPV4 and NGINX_RESOLVER_IPV6 environment variables to nginx.env (replacing the old _OFF-suffixed names) with reversed logic, giving operators cleaner control over NGINX resolver settings. Not checked yet Replaces the step-by-step install.py wizard with a menu-based interface that lets operators change individual configuration values without stepping through the full question set; the legacy wizard remains available as scripts/legacy_install.py (e.g., scripts/legacy_install.py --configure). Not checked yet Adds a Connections Tree visualization that tracks potential 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. by mapping direct and indirect communications between all devices reaching a root IP, with enriched endpoint and connection data. Not checked yet Bundles the repository-s3 plugin in the OpenSearch container, enabling snapshot storage to S3-compatible buckets. Not checked yet
4 details in Everything
└──▷ BREAKING ON UPGRADE
! NGINX_RESOLVER_IPV4_OFF and NGINX_RESOLVER_IPV6_OFF in nginx.env are renamed to NGINX_RESOLVER_IPV4 and NGINX_RESOLVER_IPV6 with their logic reversed — a working setup that set NGINX_RESOLVER_IPV4_OFF=true must now set NGINX_RESOLVER_IPV4=false (Malcolm's control scripts handle the migration automatically via ./config/env-var-actions.yml).
Malcolm v25.09.0 adds Google Threat Intelligence feed support, new Modbus detailed logging, VADR dashboards, and configurable upload/time-frame env vars.
└──▷ GET THIS VERSION
copy
$ git clone --branch v25.09.0 https://github.com/cisagov/Malcolm.git
$ git checkout v25.09.0
└──▷ USE IT
Raise the PCAP PCAP A packet capture, recorded network packets that can be inspected later. Analysts use it to reconstruct communication and investigate protocol behavior or suspicious traffic. upload limit to 20 GB to accommodate large capture files ingested via the Malcolm upload interface.
env
copy
PCAP_UPLOAD_MAX_FILE_GB=20
Set the default OpenSearch OpenSearch An open-source search and analytics engine, forked from Elasticsearch by AWS in 2021, that lets cyber tools store, query, and visualize large volumes of log or event data without licensing restrictions. Dashboards time window to the last 24 hours so analysts open to a relevant view without manual adjustment.
env
copy
DASHBOARDS_TIMEPICKER_FROM=now-24h
DASHBOARDS_TIMEPICKER_TO=now
Adds PCAP_UPLOAD_MAX_FILE_GB to upload-common.env to configure the maximum PCAP upload file size. Not checked yet Adds DASHBOARDS_TIMEPICKER_FROM and DASHBOARDS_TIMEPICKER_TO to dashboards-helper.env to configure the default search time frame for OpenSearch Dashboards. Not checked yet Adds modbus_detailed.log for improved Modbus register tracking via the updated icsnpp-modbus plugin. Not checked yet Includes tx-rx-secure.sh in files packaged by malcolm_appliance_packager.sh for easier certificate distribution. Not checked yet Supports the Google Threat Intelligence feed as a Zeek intel source for threat intelligence enrichment. Not checked yet
+6 more
show less
Integrates Validated Architecture Design Review (VADR) dashboards from CISA. Not checked yet Adds non-LVM storage option(s) for Malcolm/Hedgehog Linux ISO ISO A widely adopted international standards body that publishes technical specifications; cyber tools cite ISO standards to signal compliance with recognized benchmarks for quality, security, or interoperability. installers. Not checked yet Adds Arkime capture statistics to the Packet Capture Statistics dashboard. Not checked yet Adds icons with links to the ready and ingest statistics APIs on the Malcolm landing page. Not checked yet Renames the Zeek Intelligence dashboard to Threat Intelligence with an improved layout. Not checked yet External navigation links from context menus in Arkime and Dashboards now prompt the user before opening external sites. Not checked yet
11 details in Everything
Malcolm v25.08.1 adds Redis protocol analysis and dashboard, plus major component version updates.
└──▷ GET THIS VERSION
copy
$ git clone --branch v25.08.1 https://github.com/cisagov/Malcolm.git
$ git checkout v25.08.1
Adds Redis transport protocol parsing and a dedicated Redis dashboard for network traffic analysis. Not checked yet Updates OpenSearch OpenSearch An open-source search and analytics engine, forked from Elasticsearch by AWS in 2021, that lets cyber tools store, query, and visualize large volumes of log or event data without licensing restrictions. and OpenSearch Dashboards to v3.2.0. Not checked yet Updates Zeek to v8.0.1. Not checked yet Updates Beats and Logstash to v8.19.2. Not checked yet Updates Debian base to v13 (Trixie) for ISO ISO A widely adopted international standards body that publishes technical specifications; cyber tools cite ISO standards to signal compliance with recognized benchmarks for quality, security, or interoperability. installer images and Debian-based containers. Not checked yet
+4 more
show less
Updates NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. to v4.3.6. Not checked yet Updates Fluent Bit to v4.0.8. Not checked yet Updates Supervisor to v4.3.0. Not checked yet Standardizes debug/informational logging verbosity in Python scripts via -v, -vv, -vvv flags. Not checked yet
9 details in Everything
Malcolm v25.08.0 adds FILEBEAT_CLEANUP_VERBOSITY env var for tunable log verbosity on the processed-folder pruning script.
└──▷ GET THIS VERSION
copy
$ git clone --branch v25.08.0 https://github.com/cisagov/Malcolm.git
$ git checkout v25.08.0
└──▷ USE IT
Enable DEBUG-level output from the log-pruning script to troubleshoot how many Zeek/Suricata files are being considered and at what rate each minute.
env
copy
FILEBEAT_CLEANUP_VERBOSITY=-vvvv
Adds FILEBEAT_CLEANUP_VERBOSITY to filebeat.env to control the verbosity of the clean-processed-folder.py script; setting -vvvv enables DEBUG-level output with per-run file counts and processing rates for Zeek and Suricata log pruning. Not checked yet Performance improvements to the clean-processed-folder.py script in the filebeat container for pruning already-processed Zeek and Suricata log files. Not checked yet
2 details in Everything
Malcolm v25.07.0 adds Arkime WISE tagging, ANSI C12.22 ICS ICS Industrial Control Systems — hardware and software that monitor and control physical processes like power grids, pipelines, and manufacturing lines, making them a target for cyber tools focused on operational technology environments. protocol support, multi-instance Suricata PCAP PCAP A packet capture, recorded network packets that can be inspected later. Analysts use it to reconstruct communication and investigate protocol behavior or suspicious traffic. processing, and IANA service enrichment for Zeek.
└──▷ GET THIS VERSION
copy
$ git clone --branch v25.07.0 https://github.com/cisagov/Malcolm.git
$ git checkout v25.07.0
└──▷ USE IT
Enable the Arkime WISE GUI GUI A graphical user interface, controls such as windows, buttons and menus. It lets people use software visually rather than entering commands. so analysts can view and edit WISE tagging configuration from the web interface.
ini
copy
ARKIME_EXPOSE_WISE_GUI=true
ARKIME_ALLOW_WISE_GUI_CONFIG=true
Run multiple Suricata processes in parallel for faster offline PCAP analysis on multi-core sensors.
ini
copy
SURICATA_AUTO_ANALYZE_PCAP_PROCESSES=4
SURICATA_AUTO_ANALYZE_PCAP_THREADS=2
Enable IANA service enrichment in Zeek's known_services.log to map port numbers to human-readable service names.
ini
copy
ZEEK_DISABLE_IANA_LOOKUP=false
Adds ARKIME_EXPOSE_WISE_GUI and ARKIME_ALLOW_WISE_GUI_CONFIG to arkime.env to control exposure of the Arkime WISE GUI viewer/editor for tag-based enrichment. Not checked yet Adds ARKIME_WISE_CONFIG_PIN_CODE to arkime-secret.env for authenticating changes to the WISE configuration via the WISE GUI. Not checked yet Adds ARKIME_WISE_SERVICE_URL to arkime-secret.env for specifying the connection endpoint to the WISE service. Not checked yet Adds SURICATA_AUTO_ANALYZE_PCAP_PROCESSES to suricata-offline.env and changes the meaning and default of SURICATA_AUTO_ANALYZE_PCAP_THREADS to enable multiple concurrent Suricata instances in PCAP processing mode via UNIX socket. Not checked yet Adds ZEEK_DISABLE_IANA_LOOKUP to zeek.env (and control_vars.conf for Hedgehog Linux) to control IANA service name and description enrichment in Zeek's known_services.log. Not checked yet
+11 more
show less
Adds ANSI C12.22 ICS protocol analyzer variables to zeek.env (and control_vars.conf for Hedgehog Linux) to control the new ICSNPP C12.22 parser and log output, with a corresponding new dashboard. Not checked yet Adds ARKIME_WISE_PLUGIN and ARKIME_WISE_URL to Hedgehog Linux control_vars.conf as part of WISE integration. Not checked yet Handles comma- or semicolon-separated directories for PCAP_PROCESSED_DIRECTORY to support multiple live PCAP processing sources (e.g., Malcolm-Helm deployments). Not checked yet Handles new OPCUA Binary summary logs from the ICSNPP OPCUA Binary parser. Not checked yet Changes LS_JAVA_OPTS default heap size in logstash.env from 2500m to 3g for improved Logstash performance. Not checked yet Removes VIEWER from arkime-live.env and removes VIEWER and WISE from arkime-offline.env as these are now handled internally. Not checked yet Exposes Arkime WISE tagging features to users for enriching session data with external data sources. Not checked yet Incorporates new ANSI C12.22 ICS protocol parser with a corresponding dashboard for utility AMI traffic analysis. Not checked yet Adds IANA service name and description enrichment to Zeek's known_services.log. Not checked yet Supports multiple Suricata instances in PCAP processing mode via UNIX socket. Not checked yet Improves file pruning speed. Not checked yet
16 details in Everything
└──▷ BREAKING ON UPGRADE
! VIEWER is removed from arkime-live.env — any deployment that sets this variable manually will need to remove it.! VIEWER and WISE are removed from arkime-offline.env — any deployment that sets these variables manually will need to remove them.! The meaning and default of SURICATA_AUTO_ANALYZE_PCAP_THREADS in suricata-offline.env has changed as part of multi-instance Suricata support — review and update existing configurations accordingly.! The default LS_JAVA_OPTS heap size in logstash.env changes from 2500m to 3g — deployments with constrained memory should review this new default.
Malcolm v25.06.0 adds role-based access control role-based access control Role-based access control, where permissions are assigned to roles such as reader or administrator and users receive those roles. It makes access easier to manage than individual permission lists. via Keycloak, NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. subnet filters, and Zeek intel log extensions.
└──▷ GET THIS VERSION
copy
$ git clone --branch v25.06.0 https://github.com/cisagov/Malcolm.git
$ git checkout v25.06.0
└──▷ TRY IT
Regenerate internal OpenSearch OpenSearch An open-source search and analytics engine, forked from Elasticsearch by AWS in 2021, that lets cyber tools store, query, and visualize large volumes of log or event data without licensing restrictions. credentials required after upgrading to v25.06.0 before restarting Malcolm.
copy
$ ./scripts/auth_setup
Adds NETBOX_AUTO_POPULATE_SUBNETS to netbox-common.env to specify subnet include/exclude filters for NetBox autopopulation, preventing noisy DHCP ranges from polluting inventory. Not checked yet Adds ARKIME_INIT_… variables to opensearch.env to pass init arguments to Arkime's db.pl and Malcolm's own index template creation. Not checked yet Moves OPENSEARCH_MAX_SHARDS_PER_NODE from arkime.env to opensearch.env and renames it CLUSTER_MAX_SHARDS_PER_NODE. Not checked yet Moves NGINX_LDAP_TLS_… variables from auth-common.env to nginx.env. Not checked yet Adds role-based access control (RBAC RBAC Role-based access control, where permissions are assigned to roles such as reader or administrator and users receive those roles. It makes access easier to manage than individual permission lists. ) to Malcolm, available when the authentication method is keycloak or keycloak_remote, mapping Keycloak realm roles to OpenSearch, Arkime, and NetBox permissions and enforcing others via NGINX URI path rules. Not checked yet
+5 more
show less
Adds many new ROLE… variables to auth-common.env to configure RBAC, plus new and changed default variables in netbox.env for RBAC support. Not checked yet Malcolm's embedded Keycloak instance now automatically creates and configures the default client by ID when specified in ./config/keycloak.env. Not checked yet Changes OPENSEARCH_URL default in opensearch.env to https://opensearch:9200 for the embedded OpenSearch instance, as all internal connections now use HTTPS HTTPS HTTP carried over an encrypted TLS connection. It protects traffic in transit and lets a browser verify the server's certificate. due to the OpenSearch Security Plugin. Not checked yet Moves Zeek's zeek-kafka plugin configuration to its own file (kafka.zeek), making it easier to override via Docker volume bind mount or Kubernetes configMap. Not checked yet Extends Zeek's intel.log with additional fields using the corelight/ExtendIntel plugin. Not checked yet
10 details in Everything
└──▷ BREAKING ON UPGRADE
! OPENSEARCH_MAX_SHARDS_PER_NODE is removed from arkime.env and must now be set as CLUSTER_MAX_SHARDS_PER_NODE in opensearch.env.! NGINX_LDAP_TLS_… variables are removed from auth-common.env and must now be set in nginx.env.! Inter-container access to the embedded OpenSearch instance now requires authentication; before first startup after upgrading, run ./scripts/auth_setup and select '(Re)generate internal passwords for local primary OpenSearch instance' to generate the credential stored in .opensearch.primary.curlrc.! OPENSEARCH_URL in opensearch.env now defaults to https://opensearch:9200 (previously HTTP) when using the embedded OpenSearch instance.
Malcolm v25.05.0 adds ROC Plus ICS ICS Industrial Control Systems — hardware and software that monitor and control physical processes like power grids, pipelines, and manufacturing lines, making them a target for cyber tools focused on operational technology environments. protocol support with Zeek analyzer and makes the Zeek metrics port configurable.
└──▷ GET THIS VERSION
copy
$ git clone --branch v25.05.0 https://github.com/cisagov/Malcolm.git
$ git checkout v25.05.0
└──▷ USE IT
Disable the new ROC Plus Zeek analyzer if your environment does not have ROC Plus traffic and you want to reduce noise.
env
copy
ZEEK_DISABLE_ICS_ROC_PLUS=true
Override the default Zeek metrics port when the default conflicts with another service in your deployment.
env
copy
ZEEK_METRICS_PORT=9099
Adds ZEEK_DISABLE_ICS_ROC_PLUS to zeek.env and control_vars.conf to control whether the new ROC Plus analyzer is enabled. Not checked yet Adds ZEEK_METRICS_PORT to zeek.env and control_vars.conf to make the Zeek metrics port configurable (default blank, meaning use the default port). Not checked yet Adds support for the Emerson ROC Plus ICS protocol, including a Zeek analyzer and corresponding dashboard. Not checked yet Improves ability to upload PCAP PCAP A packet capture, recorded network packets that can be inspected later. Analysts use it to reconstruct communication and investigate protocol behavior or suspicious traffic. files via cURL. Not checked yet
4 details in Everything
Malcolm v25.04.0 adds external NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. support, new Kubernetes deployment flags, and expanded OpenSearch OpenSearch An open-source search and analytics engine, forked from Elasticsearch by AWS in 2021, that lets cyber tools store, query, and visualize large volumes of log or event data without licensing restrictions. /NetBox config keys.
└──▷ GET THIS VERSION
copy
$ git clone --branch v25.04.0 https://github.com/cisagov/Malcolm.git
$ git checkout v25.04.0
└──▷ USE IT
Point Malcolm at a pre-existing corporate NetBox instance instead of its built-in one, so asset enrichment draws from your authoritative IPAM.
ini
copy
# in config/netbox-common.env
NETBOX_MODE=external
NETBOX_URL=https://netbox.corp.example.com
# in config/netbox-secret.env
NETBOX_TOKEN=<your-netbox-api-token>
Deploy Malcolm on Kubernetes without live-capture pods and with custom container resource limits injected from a YAML file — useful for resource-constrained clusters.
copy
$ python3 control.py start --namespace malcolm --no-capture-pods --inject-resources --image-source ghcr.io/idaholab/malcolm --image-tag 25.04.0
Configure Malcolm's OpenSearch index templates for a remote Elasticsearch backend with custom lifecycle policies and rollover aliases.
ini
copy
# in config/opensearch.env
MALCOLM_NETWORK_INDEX_DEFAULT_PIPELINE=my-network-pipeline
MALCOLM_NETWORK_INDEX_LIFECYCLE_NAME=my-network-policy
MALCOLM_NETWORK_INDEX_LIFECYCLE_ROLLOVER_ALIAS=malcolm-network
MALCOLM_OTHER_INDEX_DEFAULT_PIPELINE=my-other-pipeline
MALCOLM_OTHER_INDEX_LIFECYCLE_NAME=my-other-policy
MALCOLM_OTHER_INDEX_LIFECYCLE_ROLLOVER_ALIAS=malcolm-other
Replaces NETBOX_DISABLED with NETBOX_MODE in netbox-common.env to control NetBox operating mode, including pointing Malcolm at an external NetBox instance. Not checked yet Adds NETBOX_URL to netbox-common.env and NETBOX_TOKEN to netbox-secret.env to configure an external NetBox instance. Not checked yet Adds LOGIN_REQUIRED, LOGIN_PERSISTENCE, and ISOLATED_DEPLOYMENT keys to netbox.env for finer NetBox authentication and isolation control. Not checked yet Adds MALCOLM_NETWORK_INDEX_DEFAULT_PIPELINE, MALCOLM_NETWORK_INDEX_LIFECYCLE_NAME, MALCOLM_NETWORK_INDEX_LIFECYCLE_ROLLOVER_ALIAS, MALCOLM_OTHER_INDEX_DEFAULT_PIPELINE, MALCOLM_OTHER_INDEX_LIFECYCLE_NAME, and MALCOLM_OTHER_INDEX_LIFECYCLE_ROLLOVER_ALIAS to opensearch.env to support index template customization, primarily for remote Elasticsearch backends. Not checked yet Adds EXTRACTED_FILE_ENABLE_VTOT to zeek.env as an explicit toggle for VirusTotal file submission, independent of VTOT_API2_KEY presence in zeek-secret.env. Not checked yet
+8 more
show less
Adds --inject-resources / INJECTRESOURCES flag to the Kubernetes start operation to inject container resource requests from kubernetes-container-resources.yml. Not checked yet Adds --no-capture-pods / NOCAPTUREPODSSTART flag to the Kubernetes start operation to skip deploying pods for live traffic capture and analysis. Not checked yet Adds --no-capabilities / NOCAPABILITIES flag to the Kubernetes start operation to suppress container capability modifications. Not checked yet Adds --delete-namespace / DELETENAMESPACE flag to the Kubernetes wipe operation to delete the Kubernetes namespace. Not checked yet Adds --skip-persistent-volume-checks / SKIPPERVOLCHECKS flag to the Kubernetes start operation to bypass PersistentVolume/PersistentVolumeClaim checks. Not checked yet Adds --image-source and --image-tag flags to the Kubernetes start operation to specify the container image registry and tag. Not checked yet Adds -q/--quiet option to the start/restart control script operations. Not checked yet Allows providing Kubernetes container resource requests via a YML file (kubernetes-container-resources.yml) and command-line argument on start. Not checked yet
13 details in Everything
└──▷ BREAKING ON UPGRADE
! The NETBOX_DISABLED environment variable in netbox-common.env has been replaced by NETBOX_MODE; existing configurations that set NETBOX_DISABLED must be updated.! The NETBOX_CRON variable has been removed from netbox-common.env; any configuration referencing it must be cleaned up.
Malcolm v25.03.1 adds S7comm device logs, Keycloak group/role login restrictions, and Hedgehog Kiosk capture display.
└──▷ GET THIS VERSION
copy
$ git clone --branch v25.03.1 https://github.com/cisagov/Malcolm.git
$ git checkout v25.03.1
└──▷ USE IT
Restrict Keycloak-authenticated logins to users belonging to a specific group and role, preventing access by users who authenticate but lack the required membership.
ini
copy
NGINX_REQUIRE_GROUP=malcolm-analysts
NGINX_REQUIRE_ROLE=network-monitor
Adds NGINX_REQUIRE_GROUP and NGINX_REQUIRE_ROLE to auth-common.env to enforce Keycloak group or role membership restrictions on login. Not checked yet Incorporates new S7comm device identification log, s7comm_known_devices.log, for OT/ICS ICS Industrial Control Systems — hardware and software that monitor and control physical processes like power grids, pipelines, and manufacturing lines, making them a target for cyber tools focused on operational technology environments. device tracking. Not checked yet Displays current PCAP PCAP A packet capture, recorded network packets that can be inspected later. Analysts use it to reconstruct communication and investigate protocol behavior or suspicious traffic. , Zeek, and Suricata capture results in Hedgehog Linux Kiosk mode. Not checked yet Marks newly-discovered and uninventoried devices in logs during NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. enrichment. Not checked yet Adds 'Apply recommended system tweaks automatically without asking for confirmation?' prompt to install.py, enabling unattended acceptance of sysctl.conf and grub kernel parameter changes. Not checked yet
5 details in Everything
Malcolm v25.03.0 adds Keycloak SSO SSO Single sign-on, using one identity provider to sign in to multiple applications. It reduces separate passwords and centralizes account and access management. /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. authentication alongside existing local and 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. auth methods.
└──▷ GET THIS VERSION
copy
$ git clone --branch v25.03.0 https://github.com/cisagov/Malcolm.git
$ git checkout v25.03.0
└──▷ TRY IT
Back up the NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. database before upgrading to v25.03.0 to protect inventory data during the PostgreSQL migration.
copy
$ ./scripts/netbox-backup
Adds NGINX_AUTH_MODE (replacing NGINX_BASIC_AUTH) in auth-commmon.env to select the authentication mode, with backwards-compatible handling of previously-accepted values. Not checked yet Adds keycloak.env to configure Keycloak authentication for Malcolm. Not checked yet Renames nginx-postgres to postgres.env and overhauls its variables to support the now-independent PostgreSQL container. Not checked yet Adds new environment variables to nginx.env to support Keycloak/OpenID Connect OpenID Connect OpenID Connect, a sign-in protocol built on OAuth 2.0. An application uses identity information from a trusted provider instead of maintaining a separate password for each user. integration. Not checked yet Removes NETBOX_POSTGRES_DISABLED from netbox-common.env as PostgreSQL is now a standalone service. Not checked yet
+4 more
show less
Adds Keycloak as a supported authentication provider, enabling SSO and IAM-backed access via an existing or embedded Keycloak instance. Not checked yet Decouples the postgres container from NetBox so it runs as an independent service, now also backing the embedded Keycloak instance. Not checked yet Replaces the internal NGINX web server with OpenResty (NGINX extended with Lua) to support the lua-resty-openidc OpenID OpenID An open standard for decentralized authentication that lets a user prove their identity to a site via a trusted third-party provider, so tools can delegate login without managing credentials themselves. Connect library. Not checked yet Changes ./wipe behavior so it no longer deletes PostgreSQL data (NetBox inventory and embedded Keycloak data). Not checked yet
9 details in Everything
└──▷ BREAKING ON UPGRADE
! NGINX_BASIC_AUTH is renamed to NGINX_AUTH_MODE in auth-commmon.env; automatic migration via config/env-var-actions.yml is provided but must be triggered by running ./scripts/status before starting Malcolm.! nginx-postgres.env is renamed to postgres.env and its variables are completely overhauled; automatic migration is provided but manual NetBox database backup via ./scripts/netbox-backup is strongly recommended before upgrading.! NETBOX_POSTGRES_DISABLED is removed from netbox-common.env; any configuration referencing this variable will silently have no effect after upgrade.
Malcolm v25.02.0 delivers 18x faster PCAP PCAP A packet capture, recorded network packets that can be inspected later. Analysts use it to reconstruct communication and investigate protocol behavior or suspicious traffic. processing, 4x faster NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. enrichment, and long-connection detection via a new Zeek plugin.
└──▷ GET THIS VERSION
copy
$ git clone --branch v25.02.0 https://github.com/cisagov/Malcolm.git
$ git checkout v25.02.0
└──▷ USE IT
Tune long-connection detection thresholds so Zeek flags sessions exceeding 10 min, 30 min, 1 hr, and 12 hr, and suppress notices for high-volume environments.
ini
copy
# in config/zeek.env
ZEEK_LONG_CONN_DURATIONS=600,1800,3600,43200
ZEEK_LONG_CONN_DO_NOTICE=false
ZEEK_LONG_CONN_REPEAT_LAST_DURATION=true
Raise NetBox enrichment cache limits before restarting Malcolm to sustain the 4x speedup in high-asset environments.
ini
copy
# in config/netbox-common.env
NETBOX_CACHE_SIZE=20000
NETBOX_CACHE_TTL=600
Adds ZEEK_LONG_CONN_REPEAT_LAST_DURATION, ZEEK_LONG_CONN_DO_NOTICE, and ZEEK_LONG_CONN_DURATIONS to zeek.env to configure the new corelight/zeek-long-connections plugin. Not checked yet Adds MALCOLM_NETWORK_INDEX_ALIAS and MALCOLM_OTHER_INDEX_ALIAS to opensearch.env to define index alias names required for OpenSearch OpenSearch An open-source search and analytics engine, forked from Elasticsearch by AWS in 2021, that lets cyber tools store, query, and visualize large volumes of log or event data without licensing restrictions. Security Analytics detectors. Not checked yet Increases default NETBOX_CACHE_SIZE to 10000 and NETBOX_CACHE_TTL to 300 seconds in netbox-common.env, making NetBox enrichment approximately 4x faster. Not checked yet Adds validate_local_site_policy.sh script for validating Zeek local site policy. Not checked yet Adds config/env-var-actions.yml to drive automatic migration of environment variables between Malcolm versions (moving, removing, or updating keys across .env files). Not checked yet
+5 more
show less
Includes corelight/zeek-long-connections Zeek plugin to log long connections, exposing a new zeek.conn.long field and updating the Connections dashboard. Not checked yet Suricata processing of large sets of uploaded PCAP files is now approximately 18x faster. Not checked yet Adds clear_bit field to dnp3_control.log to indicate whether the DNP3 DNP3 A serial and TCP/IP communication protocol used in industrial control systems, especially power grids and water utilities, to let control software poll and command field devices like sensors and switches. control code clear bit is set or unset. Not checked yet Adds container health checks for live capture containers that previously lacked them. Not checked yet Normalizes Windows event log (evtx) fields to more closely match Winlogbeat/Winlog fields in preparation for Sigma rule support via OpenSearch Security Analytics. Not checked yet
10 details in Everything
└──▷ BREAKING ON UPGRADE
! REDIS_CACHE_HOST and REDIS_HOST have moved from netbox.env to redis.env; old values with the netbox- prefix will prevent NetBox from connecting to Redis on startup — update them to REDIS_HOST=redis and REDIS_CACHE_HOST=redis-cache before starting Malcolm.! REDIS_CACHE_PASSWORD and REDIS_PASSWORD have moved from netbox-secret.env to redis.env.! DB_HOST and DB_NAME have moved from netbox.env to netbox-postgres.env.! DB_PASSWORD and DB_USER have moved from netbox-secret.env to netbox-postgres.env.! netbox-redis-cache.env has been removed; its settings now live in redis.env.! netbox-redis.env has been renamed to redis.env.! CONNECTION_SECONDS_SEVERITY_THRESHOLD has been removed from lookup-common.env; replace it with the new ZEEK_LONG_CONN_* variables in zeek.env.
Malcolm v25.01.0 adds Omron FINS and PostgreSQL parsers, syslog-over-UDP UDP A network protocol that sends individual messages without guaranteeing delivery or order. Applications trade built-in reliability for less overhead and can add their own recovery. /TCP TCP A network protocol that delivers a reliable, ordered stream of bytes between two endpoints. It detects lost data and retransmits it. ingestion, and Winlogbeat normalization with new config vars.
└──▷ GET THIS VERSION
copy
$ git clone --branch v25.01.0 https://github.com/cisagov/Malcolm.git
$ git checkout v25.01.0
└──▷ USE IT
Enable encrypted syslog ingestion over TCP on port 6514 with RFC 5424 RFC 5424 The IETF standard that defines the Syslog protocol's message format, severity levels, and transport rules, giving cyber tools a common structured log schema to parse and forward system events reliably. formatting so firewalled OT devices can forward logs to Malcolm securely.
ini
copy
FILEBEAT_SYSLOG_TCP_LISTEN=true
FILEBEAT_SYSLOG_TCP_PORT=6514
FILEBEAT_SYSLOG_TCP_FORMAT=rfc5424
FILEBEAT_SYSLOG_TCP_SSL=true
FILEBEAT_SYSLOG_TCP_MAX_CONNECTIONS=50
FILEBEAT_SYSLOG_TCP_MAX_MESSAGE_SIZE=20MiB
Enable the Omron FINS parser with verbose detail logging to capture granular PLC command/response data for ICS ICS Industrial Control Systems — hardware and software that monitor and control physical processes like power grids, pipelines, and manufacturing lines, making them a target for cyber tools focused on operational technology environments. network forensics.
ini
copy
ZEEK_DISABLE_ICS_OMRON_FINS=false
ZEEK_OMRON_FINS_DETAILED=true
Adds FILEBEAT_SYSLOG_TCP_LISTEN and FILEBEAT_SYSLOG_UDP_LISTEN in ./config/filebeat.env to enable syslog ingestion over TCP and/or UDP respectively. Not checked yet Adds FILEBEAT_SYSLOG_TCP_FORMAT and FILEBEAT_SYSLOG_UDP_FORMAT in ./config/filebeat.env to specify syslog message format as one of auto, rfc3164, or rfc5424 (default auto). Not checked yet Adds FILEBEAT_SYSLOG_TCP_PORT and FILEBEAT_SYSLOG_UDP_PORT in ./config/filebeat.env to configure the ports on which Malcolm accepts syslog over TCP and/or UDP. Not checked yet Adds FILEBEAT_SYSLOG_TCP_MAX_MESSAGE_SIZE and FILEBEAT_SYSLOG_UDP_MAX_MESSAGE_SIZE in ./config/filebeat.env to cap syslog message size (defaults: 10KiB for UDP, 20MiB for TCP). Not checked yet Adds FILEBEAT_SYSLOG_TCP_MAX_CONNECTIONS in ./config/filebeat.env to cap the maximum concurrent TCP connections for syslog ingestion. Not checked yet
+8 more
show less
Adds FILEBEAT_SYSLOG_TCP_SSL in ./config/filebeat.env to require TLS for syslog-over-TCP, with self-signed certs generated by ./scripts/auth_setup stored in ./filebeat/certs/. Not checked yet Adds ZEEK_DISABLE_ICS_OMRON_FINS in ./config/zeek.env and control_vars.conf to toggle the new Omron FINS protocol parser. Not checked yet Adds ZEEK_OMRON_FINS_DETAILED in ./config/zeek.env and control_vars.conf to enable verbose Omron FINS logging to omron_fins_detail.log. Not checked yet Integrates the Omron FINS ICS protocol parser (icsnpp-omron-fins) with a corresponding dashboard. Not checked yet Integrates the PostgreSQL parser (introduced in Zeek v7.1.0) with a corresponding dashboard. Not checked yet Normalizes Winlogbeat events using Fluent Bit's winlog/winevtlog and evtx event schemas. Not checked yet Clicking field values in Dashboards tables now pivots to Arkime or NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. . Not checked yet Adds a navigation pane to all non-network dashboards. Not checked yet
13 details in Everything
Malcolm v24.12.0 adds a system testing framework, threat intel feed config options, and PCAP PCAP A packet capture, recorded network packets that can be inspected later. Analysts use it to reconstruct communication and investigate protocol behavior or suspicious traffic. -level NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. enrichment control.
└──▷ GET THIS VERSION
copy
$ git clone --branch v24.12.0 https://github.com/cisagov/Malcolm.git
$ git checkout v24.12.0
└──▷ HOW TO FIND IT
Disable NetBox enrichment for a specific PCAP batch upload when you want raw traffic analysis without asset-context tagging.
📍 In the Malcolm upload page, locate the NetBox enrichment toggle and disable it before submitting your current batch of PCAPs.
Adds configuration script options for pulling from threat intel feeds. Not checked yet Adds an option on the upload page to disable NetBox enrichment for the currently-uploaded batch of PCAPs PCAPs A packet capture, recorded network packets that can be inspected later. Analysts use it to reconstruct communication and investigate protocol behavior or suspicious traffic. . Not checked yet Exposes more of the Logstash API passthrough to the Malcolm API. Not checked yet Improves the Indices, Ready, and Document Ingest Statistics APIs. Not checked yet Prompts during configuration whether to enable capture statistics. Not checked yet
+4 more
show less
Adds a simple readiness indicator to the upload page. Not checked yet Adds additional EVTX EVTX Windows XML-based binary log format used by the Event Log service to store system, application, and security events; cyber tools parse it to extract forensic artifacts from live systems or offline disk images. fields to the index template. Not checked yet Launches malcolm-test, a Malcolm system testing framework. Not checked yet Updates NetBox to v4.1.8 (major update from the v4.0.x series). Not checked yet
9 details in Everything
Malcolm v24.11.0 adds Mandiant Threat Intel integration, Kafka log forwarding, two new APIs, and OPCUA-Binary write subscription parsing.
└──▷ GET THIS VERSION
copy
$ git clone --branch v24.11.0 https://github.com/cisagov/Malcolm.git
$ git checkout v24.11.0
└──▷ USE IT
Forward all Zeek logs to a Kafka broker for downstream SIEM SIEM Security information and event management, collecting logs from many systems and correlating events to find suspicious activity. Analysts use it to investigate alerts and incidents. or stream processing ingestion.
ini
copy
ZEEK_KAFKA_ENABLED=true
ZEEK_KAFKA_BROKERS=kafka.example.com:9092
ZEEK_KAFKA_TOPIC=malcolm-zeek
Retrieve live ingest statistics from Malcolm to monitor data pipeline throughput via the new API.
copy
$ curl -sk -u analyst:password https://malcolm.example.com/mapi/ingest-stats | jq .
Adds ZEEK_KAFKA_ENABLED, ZEEK_KAFKA_BROKERS, and ZEEK_KAFKA_TOPIC to ./config/zeek.env (and control_vars.conf for Hedgehog Linux) to enable forwarding Zeek logs to Kafka via the SeisoLLC/zeek-kafka plugin. Not checked yet Adds ZEEK_DISABLE_DETECT_ROUTERS (default: true) to ./config/zeek.env and control_vars.conf, enabling an experimental Zeek script that detects routers by packet TTL TTL Time to live, a limit on how long data remains valid or how far a packet can travel. Caches use a time limit; IP packets use a hop limit. and logs them to known_routers.log. Not checked yet Adds the dashboard-export API endpoint to the Malcolm API surface. Not checked yet Adds the ingest-stats API endpoint to the Malcolm API surface. Not checked yet Adds support for pulling from the Mandiant Threat Intelligence service to feed the Zeek intelligence framework, using the google/mandiant-ti-client Python library. Not checked yet
+5 more
show less
Adds the NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. HealthCheck plugin as a default NetBox plugin and integrates it into the Malcolm services readiness status API for reporting NetBox state. Not checked yet Implements paging for the extracted files download dialog. Not checked yet Improves normalization of Zeek's intel.log to the ECS ECS Elastic Common Schema, an open specification maintained by Elastic that defines a standard field naming convention for log and event data, letting cyber tools share and correlate records without per-source field mapping. threat fields. Not checked yet Improves the Zeek Intel dashboard. Not checked yet Changes the non-live Zeek container to become available for processing uploaded PCAPs PCAPs A packet capture, recorded network packets that can be inspected later. Analysts use it to reconstruct communication and investigate protocol behavior or suspicious traffic. before an intelligence feed pull completes. Not checked yet
10 details in Everything
└──▷ BREAKING ON UPGRADE
! ZEEK_INTEL_REFRESH_ON_ENTRYPOINT is renamed to ZEEK_INTEL_REFRESH_ON_STARTUP in both ./config/zeek.env and control_vars.conf — any configuration or automation referencing the old name will break.
Malcolm v24.10.1 adds a readiness API, websocket.log support, Amazon Linux 2023 builds, and a new JA4SSH packet-count config key.
└──▷ GET THIS VERSION
copy
$ git clone --branch v24.10.1 https://github.com/cisagov/Malcolm.git
$ git checkout v24.10.1
└──▷ USE IT
Tune JA4SSH fingerprint logging granularity by setting how many SSH packets trigger a log entry.
ini
copy
ZEEK_JA4SSH_PACKET_COUNT=500
Adds ZEEK_JA4SSH_PACKET_COUNT (default 200) to ./config/zeek.env and control_vars.conf to control the logging interval packet count for ja4ssh.log SSH traffic fingerprinting. Not checked yet Adds a readiness API at https://cisagov.github.io/Malcolm/docs/api-ready.html to determine if various Malcolm services are ready. Not checked yet Adds support for parsing and indexing websocket.log from Zeek. Not checked yet Updates AWS AMI build scripts and demo setup scripts to use Amazon Linux 2023 instead of Amazon Linux 2. Not checked yet
4 details in Everything
Malcolm v24.10.0 adds Zeek HTTP header field parsing and raises the OpenSearch OpenSearch An open-source search and analytics engine, forked from Elasticsearch by AWS in 2021, that lets cyber tools store, query, and visualize large volumes of log or event data without licensing restrictions. field limit to 6000.
└──▷ GET THIS VERSION
copy
$ git clone --branch v24.10.0 https://github.com/cisagov/Malcolm.git
$ git checkout v24.10.0
Enables Zeek parsing of HTTP server and client header names, exposed as zeek.http.client_header_names and zeek.http.server_header_names fields. Not checked yet Raises the maximum field limit in OpenSearch index templates from 5000 to 6000. Not checked yet
2 details in Everything
Malcolm v24.09.0 adds Podman support, HART-IP parsing, index-splitting, and new env vars for container runtime and protocol control.
└──▷ GET THIS VERSION
copy
$ git clone --branch v24.09.0 https://github.com/cisagov/Malcolm.git
$ git checkout v24.09.0
└──▷ USE IT
Run Malcolm under Podman instead of Docker by setting the container runtime in process.env before starting.
ini
copy
MALCOLM_CONTAINER_RUNTIME=podman
Partition network indexes by event provider and date to isolate traffic by source system in OpenSearch OpenSearch An open-source search and analytics engine, forked from Elasticsearch by AWS in 2021, that lets cyber tools store, query, and visualize large volumes of log or event data without licensing restrictions. .
ini
copy
MALCOLM_NETWORK_INDEX_SUFFIX={{event.provider}}%{%y%m%d}
Disable the new HART-IP ICS ICS Industrial Control Systems — hardware and software that monitor and control physical processes like power grids, pipelines, and manufacturing lines, making them a target for cyber tools focused on operational technology environments. protocol parser on a Zeek sensor if it conflicts with existing capture rules.
ini
copy
ZEEK_DISABLE_ICS_HART_IP=true
Adds MALCOLM_CONTAINER_RUNTIME to ./config/process.env to indicate docker, podman, or kubernetes, enabling Podman support alongside Docker. Not checked yet Adds ZEEK_DISABLE_ICS_HART_IP to ./config/zeek.env (and control_vars.conf for Hedgehog Linux), settable to true to disable the new HART-IP protocol parser. Not checked yet Extends MALCOLM_NETWORK_INDEX_SUFFIX and MALCOLM_OTHER_INDEX_SUFFIX in ./config/opensearch.env to support dot-delimited field name expansion using {{ }} syntax (e.g., {{event.provider}}%{%y%m%d}). Not checked yet Integrates the HART-IP parser (icsnpp-hart-ip) for ICS protocol analysis via Zeek. Not checked yet Allows splitting indexes by arbitrary field values beyond the existing defaults. Not checked yet
+6 more
show less
Allows total index size-based pruning for opensearch-remote and elasticsearch-remote database modes. Not checked yet Includes the netbox-topology-views plugin by default in NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. . Not checked yet Allows users to use the Arkime Lua plugin without manually creating bind volume mounts. Not checked yet Adds an option to navigate backwards in Malcolm's dialog-based install.py installation and configuration script. Not checked yet Allows specifying an alternate download URL for MaxMind GeoIP GeoIP A database that maps IP addresses to geographic locations; tools use it to attribute traffic or alerts to countries, cities, or ASNs without querying external services. database files when building Docker images and the Hedgehog Linux ISO ISO A widely adopted international standards body that publishes technical specifications; cyber tools cite ISO standards to signal compliance with recognized benchmarks for quality, security, or interoperability. . Not checked yet Updates EtherNet/IP and CIP parsers to account for the new packet correlation ID. Not checked yet
11 details in Everything
Malcolm v24.08.0 adds public IP pseudo-segments, easier NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. plugin support, a reworked Windows Event dashboard, and Zeek v7.0.0.
└──▷ GET THIS VERSION
copy
$ git clone --branch v24.08.0 https://github.com/cisagov/Malcolm.git
$ git checkout v24.08.0
Adds netbox tag to any logs passed into the netbox_enrich.rb script in the Logstash enrichment pipeline for easier filtering and identification. Not checked yet Adds public pseudo-segments for public IP addresses to improve network segmentation visibility. Not checked yet Allows users to more easily add NetBox plugins, and runs the netbox-initializers plugin on startup even during a NetBox database backup preload. Not checked yet ISO ISO A widely adopted international standards body that publishes technical specifications; cyber tools cite ISO standards to signal compliance with recognized benchmarks for quality, security, or interoperability. installer now prompts users to format other drives for artifact storage rather than doing it automatically. Not checked yet Upgrades Zeek to v7.0.0. Not checked yet
+4 more
show less
Upgrades Arkime to v5.4.0. Not checked yet Upgrades OpenSearch OpenSearch An open-source search and analytics engine, forked from Elasticsearch by AWS in 2021, that lets cyber tools store, query, and visualize large volumes of log or event data without licensing restrictions. and OpenSearch Dashboards to v2.16.0. Not checked yet Upgrades capa to v7.2.0. Not checked yet Specifies resource requests for some containers needed for Kubernetes deployments. Not checked yet
9 details in Everything
Malcolm v24.07.0 adds GE SRTP OT protocol analysis with a new env var to control it, plus a restart script service argument.
└──▷ GET THIS VERSION
copy
$ git clone --branch v24.07.0 https://github.com/cisagov/Malcolm.git
$ git checkout v24.07.0
└──▷ USE IT
Enable the GE SRTP analyzer on a sensor that monitors GE-heavy OT networks by flipping the default off switch.
ini
copy
ZEEK_DISABLE_ICS_GE_SRTP=false
Adds ZEEK_DISABLE_ICS_GE_SRTP to zeek.env and control_vars.conf to toggle the new GE SRTP network analyzer; defaults to true (analyzer disabled) given the protocol's uncommon use in OT environments. Not checked yet Adds optional service argument to the restart script, allowing targeted restart of a single Malcolm service. Not checked yet Integrates the ICSNPP GE SRTP network analyzer for passive analysis of GE SRTP industrial protocol traffic. Not checked yet MISP feed pulls now specify JSON as the preferred format via HTTP headers, improving feed ingestion reliability. Not checked yet Removes long-deprecated net-map.json file support. Not checked yet
5 details in Everything
└──▷ BREAKING ON UPGRADE
! Support for the long-deprecated net-map.json file has been removed; any existing configurations relying on it will no longer function.! docker compose bind mounts now return an error instead of silently creating empty directories when a source file or directory is missing — setups with missing mount sources will fail on upgrade.
Malcolm v24.06.0 adds multi-site NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. enrichment, JA4 JA4 A network fingerprinting method that hashes observable TLS handshake fields into a short, readable tag, giving cyber tools a stable, version-agnostic way to classify clients and detect anomalies. + TLS fingerprinting, EVTX EVTX Windows XML-based binary log format used by the Event Log service to store system, application, and security events; cyber tools parse it to extract forensic artifacts from live systems or offline disk images. upload, and ACID OT detection for ICS ICS Industrial Control Systems — hardware and software that monitor and control physical processes like power grids, pipelines, and manufacturing lines, making them a target for cyber tools focused on operational technology environments. 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. behaviors.
└──▷ GET THIS VERSION
copy
$ git clone --branch v24.06.0 https://github.com/cisagov/Malcolm.git
$ git checkout v24.06.0
Adds platform architecture and machine boot time fields to the Malcolm version API. Not checked yet Replaces 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. TLS fingerprinting with JA4+ across all TLS traffic analysis. Not checked yet Supports uploading Windows Event Log .evtx files for ingestion and analysis, with an updated associated dashboard. Not checked yet Incorporates ATT&CK-based Control-system Indicator Detection for Zeek (ACID), alerting on ATT&CK for ICS behaviors across OT protocols. Not checked yet Supports enrichment from a NetBox inventory across multiple sites, with per-site assignment for uploaded PCAP PCAP A packet capture, recorded network packets that can be inspected later. Analysts use it to reconstruct communication and investigate protocol behavior or suspicious traffic. , Hedgehog Linux sensors, and live capture. Not checked yet
+2 more
show less
Generates new forwarder SSL SSL A cryptographic protocol for encrypting network connections, now deprecated in favor of TLS but whose name persists colloquially. Cyber tools reference it when handling HTTPS or other encrypted-channel inspection and termination. keys on-the-fly when transferring sessions between Malcolm and Hedgehog Linux. Not checked yet Adds navigation pane links in most dashboards to non-network log dashboards (resource monitoring, Windows Event logs, etc.). Not checked yet
7 details in Everything
└──▷ BREAKING ON UPGRADE
! NetBox is upgraded from v3.6.7 to v4.0.6; built-in migrations do not handle this jump, so existing NetBox data (Sites, IPAM Prefixes, DCIM Devices, etc.) will likely error on upgrade. Before upgrading, export all NetBox data via *Export* > *All Data (CSV)*. Malcolm's NetBox backup-and-restore will not work across this version gap. If errors occur after upgrading, stop Malcolm and clear ./netbox/postgres/* and ./netbox/redis/*, then restart and recreate the inventory.
Malcolm v24.05.0 adds ARM64 ARM64 A 64-bit CPU architecture from ARM Holdings, used in mobile chips, Apple Silicon, and cloud servers; cyber tools target it to run natively on those platforms instead of relying on emulation. support, new env vars for Arkime/Zeek tuning, and custom log-ingestion tags.
└──▷ GET THIS VERSION
copy
$ git clone --branch v24.05.0 https://github.com/cisagov/Malcolm.git
$ git checkout v24.05.0
└──▷ USE IT
Label all traffic ingested from a specific sensor so it can be filtered as a group in OpenSearch OpenSearch An open-source search and analytics engine, forked from Elasticsearch by AWS in 2021, that lets cyber tools store, query, and visualize large volumes of log or event data without licensing restrictions. Dashboards.
env
copy
EXTRA_TAGS=site-a-sensor-1
Switch Malcolm to weekly Arkime indexes and increase the SPI SPI Serial Peripheral Interface, a synchronous communication bus standard used to connect microcontrollers to sensors, flash memory, and other peripherals at short range; cyber tools use it to read or write firmware on embedded devices. data window to cover more index periods.
env
copy
ARKIME_SPI_DATA_MAX_INDICES=52
Run Malcolm natively on an ARM64 host by pulling the architecture-specific image tag.
copy
$ docker pull ghcr.io/idaholab/malcolm/zeek:24.05.0-arm64
Adds ARKIME_SPI_DATA_MAX_INDICES to arkime.env (default 7) to control spiDataMaxIndexes in Arkime's config.ini, useful when changing the Arkime index period from daily to weekly or hourly. Not checked yet Adds EXTRA_TAGS to upload-common.env to attach custom tags to logs forwarded to Logstash by FileBeat at ingestion time, making it easier to group traffic by sensor. Not checked yet Adds new and modified environment variables to zeek-live.env for tuning Zeek live-capture resource utilization and performance on Malcolm. Not checked yet Adds new environment variables to Hedgehog Linux's control_vars.conf for tuning Zeek live-capture resource utilization and performance on Hedgehog Linux. Not checked yet Adds new environment variables to Hedgehog Linux's control_vars.conf for tuning Arkime capture settings on the sensor, reaching parity with the arkime-live container in Malcolm. Not checked yet
+1 more
show less
Adds native ARM64/AArch64 AArch64 The 64-bit execution state of the ARM architecture, defined by Arm Ltd., offering a wider register file and cleaner instruction set than 32-bit ARM; cyber tools target it to run natively on ARM-based servers, phones, and embedded devices. support; ./scripts/configure auto-detects the architecture and adjusts image: names in docker-compose.yml, or images can be selected manually by appending -arm64 to the tag (e.g., ghcr.io/idaholab/malcolm/zeek:24.05.0-arm64). Not checked yet
6 details in Everything
Malcolm v24.04.0 adds extracted-file UI access from Hedgehog sensors, carved-file pruning thresholds, JA4 JA4 A network fingerprinting method that hashes observable TLS handshake fields into a short, readable tag, giving cyber tools a stable, version-agnostic way to classify clients and detect anomalies. + in Arkime, and ISO ISO A widely adopted international standards body that publishes technical specifications; cyber tools cite ISO standards to signal compliance with recognized benchmarks for quality, security, or interoperability. downloads from GitHub Releases.
└──▷ GET THIS VERSION
copy
$ git clone --branch v24.04.0 https://github.com/cisagov/Malcolm.git
$ git checkout v24.04.0
└──▷ USE IT
Prevent carved-file storage exhaustion by capping total disk usage at 80% and pruning files larger than 10 GB, checking every 10 minutes.
ini
copy
EXTRACTED_FILE_PRUNE_THRESHOLD_TOTAL_DISK_USAGE_PERCENT=80
EXTRACTED_FILE_PRUNE_THRESHOLD_MAX_SIZE=10737418240
EXTRACTED_FILE_PRUNE_INTERVAL_SECONDS=600
Differentiate Malcolm-managed dashboards from other sources by prepending a namespace prefix on import.
ini
copy
DASHBOARDS_PREFIX=malcolm-
Adds EXTRACTED_FILE_PRUNE_THRESHOLD_MAX_SIZE, EXTRACTED_FILE_PRUNE_THRESHOLD_TOTAL_DISK_USAGE_PERCENT, and EXTRACTED_FILE_PRUNE_INTERVAL_SECONDS to zeek.env so operators can set automatic deletion thresholds for carved files to prevent storage exhaustion. Not checked yet Adds ARKIME_QUERY_ALL_INDICES to arkime.env to control the queryAllIndices setting in Arkime's config.ini. Not checked yet Adds DASHBOARDS_PREFIX to dashboards-helper.env so a prefix can be prepended to imported dashboards in OpenSearch OpenSearch An open-source search and analytics engine, forked from Elasticsearch by AWS in 2021, that lets cyber tools store, query, and visualize large volumes of log or event data without licensing restrictions. Dashboards or Kibana, distinguishing Malcolm's dashboards from those of other sources. Not checked yet Adds ZEEK_INTEL_REFRESH_CRON_EXPRESSION to zeek-offline.env to enable Hedgehog Linux sensors to periodically refresh their Zeek intelligence files on a configurable schedule. Not checked yet Zeek-extracted files scanned and preserved on a Hedgehog Linux sensor can now be accessed via the extracted files download user interface. Not checked yet
+4 more
show less
Includes the JA4+ plugin in Arkime for enriched TLS/network fingerprinting. Not checked yet Official ISO installer images for Malcolm and Hedgehog Linux can now be downloaded from the GitHub Releases page, split into 2 GB chunks reassembled via release_cleaver.sh (Bash) or release_cleaver.ps1 (PowerShell). Not checked yet Default OpenSearch Anomaly Detection plugin detectors are now created with category fields for high cardinality, enabling finer breakdown of anomaly contributors. Not checked yet Zeek diagnostic logs capture_loss and stats are now parsed by default after being removed from LOGSTASH_ZEEK_IGNORED_LOGS in logstash.env, eliminating the need for manual configuration. Not checked yet
9 details in Everything
└──▷ BREAKING ON UPGRADE
! ZEEK_CRON has been removed from zeek-live.env and ZEEK_INTEL_REFRESH_CRON_EXPRESSION has been removed from zeek.env and moved to zeek-offline.env; deployments referencing these variables in their old locations must migrate them.! Environment variables used for configuring Malcolm have been reorganized across .env files in the ./config directory; re-running ./scripts/configure is required on upgrade.
Malcolm v24.03.1 adds auto-storage setup, Arkime custom-index awareness, NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. auto-prefix creation, and Suricata EVE log rotation controls.
└──▷ GET THIS VERSION
copy
$ git clone --branch v24.03.1 https://github.com/cisagov/Malcolm.git
$ git checkout v24.03.1
└──▷ USE IT
Enable per-thread EVE JSON output and rotate log files hourly to reduce file-size pressure and improve Suricata log ingestion reliability.
ini
copy
SURICATA_EVE_THREADED=true
SURICATA_EVE_ROTATE_INTERVAL=1h
Automatically create NetBox subnet prefixes for unrecognized RFC1918 RFC1918 IETF standard that reserves three IPv4 address ranges (10.x, 172.16–31.x, 192.168.x) for private networks, never routed on the public internet, giving tools a reliable way to identify internal traffic. traffic during enrichment, and enable service lookups on destination IP/port pairs.
ini
copy
NETBOX_AUTO_CREATE_PREFIX=true
NETBOX_ENRICHMENT_LOOKUP_SERVICE=true
Adds SURICATA_EVE_THREADED env var to suricata.env to enable threaded EVE JSON file output (default false). Not checked yet Adds SURICATA_EVE_ROTATE_INTERVAL env var to suricata.env to control eve.json file rotation interval (default 1h). Not checked yet Adds NETBOX_AUTO_CREATE_PREFIX to netbox-common.env so Logstash automatically creates and assigns NetBox subnet prefixes (e.g., /16, /24, /20) for observed traffic that falls outside any existing prefix. Not checked yet Adds NETBOX_ENRICHMENT_LOOKUP_SERVICE to netbox-common.env to control whether destination IP/port services are looked up during NetBox enrichment. Not checked yet Adds ARKIME_DEBUG_LEVEL=0 to arkime.env to expose Arkime's debug level setting via environment variable. Not checked yet
+4 more
show less
ISO ISO A widely adopted international standards body that publishes technical specifications; cyber tools cite ISO standards to signal compliance with recognized benchmarks for quality, security, or interoperability. -installed Malcolm instances now automatically detect and format storage devices larger than 100 GB for use as OpenSearch OpenSearch An open-source search and analytics engine, forked from Elasticsearch by AWS in 2021, that lets cyber tools store, query, and visualize large volumes of log or event data without licensing restrictions. data store, PCAP PCAP A packet capture, recorded network packets that can be inspected later. Analysts use it to reconstruct communication and investigate protocol behavior or suspicious traffic. , and log storage. Not checked yet Official Malcolm and Hedgehog Linux ISO installer images are now downloadable from the GitHub releases page, split into 2 GB chunks reassembled via release_cleaver.sh (Bash) or release_cleaver.ps1 (PowerShell). Not checked yet Adds the Community ID Community ID A vendor-neutral network flow hashing standard, maintained by Corelight, that produces a consistent identifier for a connection across different tools so analysts can correlate events from disparate data sources. field to Zeek's notice.log. Not checked yet Standardizes all OpenSearch Dashboards table visualizations to return 100 rows and sets otherBucket: true so users see when additional rows exist outside the displayed set. Not checked yet
9 details in Everything
└──▷ BREAKING ON UPGRADE
! NETBOX_PRELOAD_PREFIXES has been removed from netbox-common.env and replaced by NETBOX_AUTO_CREATE_PREFIX; existing configs referencing NETBOX_PRELOAD_PREFIXES will have no effect.! LOGSTASH_NETBOX_ENRICHMENT is renamed to NETBOX_ENRICHMENT (moved from logstash.env to netbox-common.env).! LOGSTASH_NETBOX_AUTO_POPULATE is renamed to NETBOX_AUTO_POPULATE (moved from logstash.env to netbox-common.env).! LOGSTASH_NETBOX_CACHE_SIZE is renamed to NETBOX_CACHE_SIZE (moved from logstash.env to netbox-common.env).! LOGSTASH_NETBOX_CACHE_TTL is renamed to NETBOX_CACHE_TTL (moved from logstash.env to netbox-common.env).! LOG_CLEANUP_MINUTES and ZIP_CLEANUP_MINUTES are moved from upload-common.env to filebeat.env; existing overrides in upload-common.env will no longer apply.! Environment variables across ./config/ have been reorganized; re-running ./scripts/configure is strongly recommended to avoid misconfiguration.
Malcolm v24.03.0 adds Profinet IO CM parsing, MISP feed endpoints, JSON-delimited Zeek log import, and non-network log dashboards.
└──▷ GET THIS VERSION
copy
$ git clone --branch v24.03.0 https://github.com/cisagov/Malcolm.git
$ git checkout v24.03.0
└──▷ USE IT
Enable the Profinet IO CM parser and enforce SSL SSL A cryptographic protocol for encrypting network connections, now deprecated in favor of TLS but whose name persists colloquially. Cyber tools reference it when handling HTTPS or other encrypted-channel inspection and termination. verification against a MISP intel feed in your Malcolm deployment.
ini
copy
# in ./config/zeek.env
ZEEK_DISABLE_ICS_PROFINET_IO_CM=
ZEEK_INTEL_FEED_SSL_CERTIFICATE_VERIFICATION=true
ZEEK_JSON=true
Adds ZEEK_DISABLE_ICS_PROFINET_IO_CM to zeek.env to control the new ICSNPP Profinet IO CM parser integration. Not checked yet Adds ZEEK_INTEL_FEED_SSL_CERTIFICATE_VERIFICATION to zeek.env to control SSL certificate verification when querying TAXII TAXII A protocol for sharing threat intelligence over HTTPS, commonly carrying STIX data. It lets tools retrieve and exchange intelligence from compatible services. or MISP feeds. Not checked yet Adds ZEEK_JSON to zeek.env to configure Zeek log output in JSON format. Not checked yet Supports /attributes and /events endpoints from MISP feeds for Zeek intel generation. Not checked yet Incorporates the ICSNPP Profinet IO CM parser for ICS ICS Industrial Control Systems — hardware and software that monitor and control physical processes like power grids, pipelines, and manufacturing lines, making them a target for cyber tools focused on operational technology environments. /OT protocol visibility. Not checked yet
+2 more
show less
Supports JSON-delimited import format for Zeek logs. Not checked yet Adds dashboards for non-network log data sources. Not checked yet
7 details in Everything
Malcolm v24.02.0 adds Raspberry Pi support for Hedgehog Linux, Arkime ILM/ISM config, per-dataset NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. enrichment, and live capture statistics reporting.
└──▷ GET THIS VERSION
copy
$ git clone --branch v24.02.0 https://github.com/cisagov/Malcolm.git
$ git checkout v24.02.0
└──▷ USE IT
Enable Arkime ILM with a 90-day retention window and hot/warm index tiering to manage long-term PCAP PCAP A packet capture, recorded network packets that can be inspected later. Analysts use it to reconstruct communication and investigate protocol behavior or suspicious traffic. index storage.
ini
copy
INDEX_MANAGEMENT_ENABLED=true
INDEX_MANAGEMENT_OPTIMIZATION_PERIOD=30d
INDEX_MANAGEMENT_RETENTION_TIME=90d
INDEX_MANAGEMENT_OLDER_SESSION_REPLICAS=0
INDEX_MANAGEMENT_HISTORY_RETENTION_WEEKS=13
INDEX_MANAGEMENT_SEGMENTS=1
INDEX_MANAGEMENT_HOT_WARM_ENABLED=true
Restrict NetBox enrichment to only Suricata alerts and Zeek connection logs, reducing Logstash processing overhead in high-volume deployments.
ini
copy
LOGSTASH_NETBOX_ENRICHMENT_DATASETS=suricata.alert,zeek.conn
Enable Suricata live capture statistics reporting so Malcolm can track decoder events and packet loss in near-real-time.
ini
copy
SURICATA_STATS_ENABLED=true
SURICATA_STATS_EVE_ENABLED=true
SURICATA_STATS_INTERVAL=30
SURICATA_STATS_DECODER_EVENTS=true
Adds INDEX_MANAGEMENT_ENABLED, INDEX_MANAGEMENT_OPTIMIZATION_PERIOD, INDEX_MANAGEMENT_RETENTION_TIME, INDEX_MANAGEMENT_OLDER_SESSION_REPLICAS, INDEX_MANAGEMENT_HISTORY_RETENTION_WEEKS, INDEX_MANAGEMENT_SEGMENTS, and INDEX_MANAGEMENT_HOT_WARM_ENABLED in arkime.env to configure Arkime ILM/ISM index management, retention periods, and hot/warm storage design. Not checked yet Adds LOGSTASH_NETBOX_ENRICHMENT_DATASETS in logstash.env to control which provider.dataset log types receive NetBox enrichment (comma-separated list, or all to enrich every log). Not checked yet Adds LOGSTASH_ZEEK_IGNORED_LOGS in logstash.env to specify which Zeek log types are dropped by Logstash before processing. Not checked yet Adds SURICATA_STATS_ENABLED, SURICATA_STATS_EVE_ENABLED, SURICATA_STATS_INTERVAL, and SURICATA_STATS_DECODER_EVENTS in suricata-live.env and ZEEK_DISABLE_STATS in zeek-live.env to enable Malcolm reporting live Zeek and Suricata capture statistics to itself. Not checked yet Adds EXTRACTED_FILE_HTTP_SERVER_MAGIC in zeek.env to enable libmagic-based MIME type display for Zeek-extracted files on the download page. Not checked yet
+6 more
show less
Adds NETBOX_DEFAULT_AUTOCREATE_MANUFACTURER and NETBOX_DEFAULT_FUZZY_THRESHOLD in netbox-common.env to tune manufacturer OUI fuzzy-matching during NetBox autopopulation. Not checked yet Adds NGINX_DASHBOARDS_PREFIX and NGINX_DASHBOARDS_PROXY_PASS in dashboards.env to explicitly override auto-configured pivot-link and redirect values for Elasticsearch/Kibana backend deployments. Not checked yet Changes default PCAP storage format to zstd(3) for new installations, reducing storage overhead. Not checked yet Adds Hedgehog Linux SD card image build support for Raspberry Pi. Not checked yet Adds direct links from the NetBox devices view to Dashboards and Arkime for pivot-based investigation. Not checked yet Updates Arkime to v5.0.0, Zeek to v6.1.1, Capa to v7.0.1, YARA to v4.5.0, Beats to v8.12.1, and Logstash to v8.12.1. Not checked yet
11 details in Everything
Malcolm v24.01.0 adds a new landing page, password-protected file-carve downloads, and fully customizable OpenSearch OpenSearch An open-source search and analytics engine, forked from Elasticsearch by AWS in 2021, that lets cyber tools store, query, and visualize large volumes of log or event data without licensing restrictions. index patterns via new env vars.
└──▷ GET THIS VERSION
copy
$ git clone --branch v24.01.0 https://github.com/cisagov/Malcolm.git
$ git checkout v24.01.0
└──▷ USE IT
Enable password-protected zip downloads of Zeek-carved files so analysts can safely retrieve potentially malicious files over HTTP.
ini
copy
EXTRACTED_FILE_HTTP_SERVER_ZIP=true
EXTRACTED_FILE_HTTP_SERVER_KEY=infected
Partition network traffic logs into monthly OpenSearch indexes instead of the default daily suffix, and keep other logs (nginx, beats) on a daily schedule.
ini
copy
MALCOLM_NETWORK_INDEX_PATTERN=arkime_sessions3-*
MALCOLM_NETWORK_INDEX_TIME_FIELD=firstPacket
MALCOLM_NETWORK_INDEX_SUFFIX=%{%y%m}
MALCOLM_OTHER_INDEX_PATTERN=malcolm_beats_*
MALCOLM_OTHER_INDEX_TIME_FIELD=@timestamp
MALCOLM_OTHER_INDEX_SUFFIX=%{%y%m%d}
ARKIME_NETWORK_INDEX_PATTERN=arkime_sessions3-*
ARKIME_NETWORK_INDEX_TIME_FIELD=firstPacket
Set Arkime to rotate its session index weekly rather than daily to reduce index overhead on lower-volume sensors.
ini
copy
ARKIME_ROTATE_INDEX=weekly
Adds ARKIME_ROTATE_INDEX to arkime.env (default daily) to control Arkime index rotation frequency. Not checked yet Adds MALCOLM_NETWORK_INDEX_PATTERN, MALCOLM_NETWORK_INDEX_TIME_FIELD, MALCOLM_NETWORK_INDEX_SUFFIX, MALCOLM_OTHER_INDEX_PATTERN, MALCOLM_OTHER_INDEX_TIME_FIELD, MALCOLM_OTHER_INDEX_SUFFIX, ARKIME_NETWORK_INDEX_PATTERN, and ARKIME_NETWORK_INDEX_TIME_FIELD to opensearch.env for full control over how network and other log indexes are named and time-stamped in OpenSearch/Elasticsearch. Not checked yet Adds EXTRACTED_FILE_HTTP_SERVER_ZIP to zeek.env (default false) to enable downloading carved files as a password-protected .zip archive. Not checked yet Changes the default value of EXTRACTED_FILE_HTTP_SERVER_KEY in zeek-secret.env to infected, setting the default password for carved-file zip downloads. Not checked yet Adds a new Malcolm instance landing page. Not checked yet
+2 more
show less
Adds an 'all files except common plain text files' option for Malcolm's file carving to match Hedgehog Linux capability. Not checked yet Improves NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. device type library import by using the official import script. Not checked yet
7 details in Everything
└──▷ BREAKING ON UPGRADE
! The default value of EXTRACTED_FILE_HTTP_SERVER_KEY in zeek-secret.env is changed to infected; any automation or documentation relying on the previous default password for carved-file downloads will need to be updated.
Malcolm v23.12.1 adds new env vars for Suricata/Zeek tuning, direct-capture Arkime config, and API routing for component endpoints.
└──▷ GET THIS VERSION
copy
$ git clone --branch v23.12.1 https://github.com/cisagov/Malcolm.git
$ git checkout v23.12.1
└──▷ USE IT
Disable all OT/ICS ICS Industrial Control Systems — hardware and software that monitor and control physical processes like power grids, pipelines, and manufacturing lines, making them a target for cyber tools focused on operational technology environments. Suricata analysis in environments where ICS alerts create noise — set the variable before starting Malcolm.
env
copy
SURICATA_DISABLE_ICS_ALL=true
Speed up Zeek threat-intel feed refreshes by increasing the number of parallel download threads.
env
copy
ZEEK_INTEL_REFRESH_THREADS=4
Query the NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. component API directly through the unified Malcolm API gateway without opening a separate port.
copy
$ curl -sk https://<malcolm-host>/mapi/netbox/api/dcim/sites/ | python3 -m json.tool
Adds SURICATA_DISABLE_ICS_ALL environment variable to disable OT/ICS analysis in Suricata. Not checked yet Adds ZEEK_INTEL_REFRESH_THREADS environment variable to control the number of threads used for Zeek intel feed pulls. Not checked yet Routes /mapi/opensearch/, /mapi/logstash/, and /mapi/netbox/ from the Malcolm API endpoint through to their respective component APIs. Not checked yet Provides alternate configuration for Arkime capture to listen on a network interface directly rather than post-processing PCAPs PCAPs A packet capture, recorded network packets that can be inspected later. Analysts use it to reconstruct communication and investigate protocol behavior or suspicious traffic. . Not checked yet Has install.py offer to pull Docker images during setup. Not checked yet
+1 more
show less
Preserves Arkime's config.ini on upgrade, only overwriting with config.orig.ini when config.ini does not already exist. Not checked yet
6 details in Everything
Malcolm v23.12.0 adds ELITEWOLF signatures, custom Suricata/Zeek config, and new environment-variable tuning knobs
└──▷ GET THIS VERSION
copy
$ git clone --branch v23.12.0 https://github.com/cisagov/Malcolm.git
$ git checkout v23.12.0
Adds an environment variable to control Arkime's freeSpaceG setting, governing when PCAP PCAP A packet capture, recorded network packets that can be inspected later. Analysts use it to reconstruct communication and investigate protocol behavior or suspicious traffic. files are deleted to reclaim disk space. Not checked yet Adds an environment variable to tune Suricata's max-pending-packets threshold for high-traffic environments. Not checked yet Allows users to include additional Suricata config YML files alongside the default configuration. Not checked yet Allows users to supply custom Zeek config files and customize Site::local_nets for local network definitions. Not checked yet Integrates nsacyber/ELITEWOLF ICS ICS Industrial Control Systems — hardware and software that monitor and control physical processes like power grids, pipelines, and manufacturing lines, making them a target for cyber tools focused on operational technology environments. /OT signatures into Malcolm's default rule set. Not checked yet
+5 more
show less
Adds an option to auto-create catch-all NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. IPAM prefixes for private IP address space. Not checked yet Uses prefix.description instead of VRF VRF A Virtual Routing and Forwarding instance is a router feature that maintains multiple independent routing tables on one device, letting a cyber tool isolate traffic flows or simulate separate network segments without extra hardware. for identifying subnets in NetBox. Not checked yet Enables the OpenSearch OpenSearch An open-source search and analytics engine, forked from Elasticsearch by AWS in 2021, that lets cyber tools store, query, and visualize large volumes of log or event data without licensing restrictions. Dashboards condensed header UI mode. Not checked yet Updates Zeek to v6.1.0 with corresponding Logstash parser updates. Not checked yet Replaces the kbn_sankey_vis plugin with Vega-based visualizations for Sankey diagrams. Not checked yet
10 details in Everything
Malcolm v23.10.0 adds OpenSearch OpenSearch An open-source search and analytics engine, forked from Elasticsearch by AWS in 2021, that lets cyber tools store, query, and visualize large volumes of log or event data without licensing restrictions. /Elasticsearch dual output, a capture-only dockerized Hedgehog mode, and per-port EtherNet/IP parser config.
└──▷ GET THIS VERSION
copy
$ git clone --branch v23.10.0 https://github.com/cisagov/Malcolm.git
$ git checkout v23.10.0
Allows specifying ports for the EtherNet/IP parser via environment variable. Not checked yet Supports both OpenSearch and Elasticsearch as output destinations. Not checked yet Adds a capture-only Malcolm configuration (also known as dockerized Hedgehog ) for lightweight sensor deployments. Not checked yet Allows specifying an Arkime password hash secret for Viewer clusters. Not checked yet
4 details in Everything
Malcolm v23.09.0 adds environment-variable control of Zeek ICS ICS Industrial Control Systems — hardware and software that monitor and control physical processes like power grids, pipelines, and manufacturing lines, making them a target for cyber tools focused on operational technology environments. parsers and fully automated CLI-driven installation.
└──▷ GET THIS VERSION
copy
$ git clone --branch v23.09.0 https://github.com/cisagov/Malcolm.git
$ git checkout v23.09.0
Enables or disables Zeek's ICS parsers via environment variable for runtime protocol-parser control. Not checked yet Supports fully automated configuration and installation via command-line arguments to install.py and control.py. Not checked yet Improves field normalization for BACnet BACnet A communication protocol for building automation systems, standardized as ASHRAE 135, covering HVAC, lighting, and access control devices. Cyber tools use it to discover and interact with building infrastructure on IP or serial networks. and Modbus traffic. Not checked yet
3 details in Everything
Malcolm v23.08.0 adds FilePond-based upload UI and YAML-driven NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. preloading via netbox-initializers.
└──▷ GET THIS VERSION
copy
$ git clone --branch v23.08.0 https://github.com/cisagov/Malcolm.git
$ git checkout v23.08.0
Supports dropping YAML files for NetBox objects to be preloaded at startup via the netbox-initializers plugin. Not checked yet Replaces the defunct jQuery-File-Upload with FilePond in the Network Traffic Artifact Upload interface and backend. Not checked yet
2 details in Everything
Malcolm v23.07.0 adds passive NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. inventory population, bacnet_device_control.log parsing, and Arkime field actions support.
└──▷ GET THIS VERSION
copy
$ git clone --branch v23.07.0 https://github.com/cisagov/Malcolm.git
$ git checkout v23.07.0
Adds bacnet_device_control.log parsing produced by the icsnpp-bacnet Zeek parser for BACnet BACnet A communication protocol for building automation systems, standardized as ASHRAE 135, covering HVAC, lighting, and access control devices. Cyber tools use it to discover and interact with building infrastructure on IP or serial networks. device control traffic. Not checked yet Populates NetBox inventory via passively-gathered network traffic metadata (basic functionality). Not checked yet Supports Arkime field actions in the Malcolm UI. Not checked yet Adds option to enable SSH via password in Hedgehog's configure-interfaces.py script. Not checked yet Switches Malcolm Docker image packaging from .tar.gz to .tar.xz for better compression and smaller ISO ISO A widely adopted international standards body that publishes technical specifications; cyber tools cite ISO standards to signal compliance with recognized benchmarks for quality, security, or interoperability. file size. Not checked yet
+2 more
show less
Improves identification of the source of third-party logs sent via Fluent Bit. Not checked yet Uses an init container in Kubernetes startup to ensure necessary directories are created under PersistentVolume objects before startup. Not checked yet
7 details in Everything
Malcolm v23.05.0 adds Kubernetes deployment support, ICSNPP-Synchrophasor parsing, and migrates all settings to .env files in config/.
└──▷ GET THIS VERSION
copy
$ git clone --branch v23.05.0 https://github.com/cisagov/Malcolm.git
$ git checkout v23.05.0
└──▷ TRY IT
Reconfigure a fresh Malcolm v23.05.0 installation after moving away from the old docker-compose.yml-based settings.
copy
$ ./scripts/configure && ./scripts/auth_setup
Use the new short-form configure alias instead of the full install script path.
copy
$ ./scripts/configure
Migrates all Malcolm settings from environment variables in docker-compose.yml to .env files inside the config directory, with reconfiguration via ./scripts/configure and ./scripts/auth_setup. Not checked yet Adds ./scripts/configure as an alias for ./scripts/install.py --configure. Not checked yet Integrates the ICSNPP-Synchrophasor parser for synchrophasor protocol analysis. Not checked yet Supports Malcolm deployment with Kubernetes Beta , including user-defined persistent volumes, Secrets for sensitive environment variables, and exposure of TCP TCP A network protocol that delivers a reliable, ordered stream of bytes between two endpoints. It detects lost data and retransmits it. services. Not checked yet Replaces the name-map-ui container with NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. for asset identification. Not checked yet
5 details in Everything
└──▷ BREAKING ON UPGRADE
! Settings are no longer read from environment variables at the top of docker-compose.yml; they must now be in .env files inside the config directory. Upgrading from a previous version is not recommended — shut down Malcolm, rename the old installation directory, and reconfigure from scratch using ./scripts/configure and ./scripts/auth_setup.! The locations of a number of configuration files have changed; existing config file paths from prior versions are no longer valid.! The name-map-ui container has been removed; asset identification now goes through NetBox.
Malcolm v23.04.0 adds tx-rx-secure.sh for SSL SSL A cryptographic protocol for encrypting network connections, now deprecated in favor of TLS but whose name persists colloquially. Cyber tools reference it when handling HTTPS or other encrypted-channel inspection and termination. file transfers, upgrades Zeek to v5.2.0, and migrates to GHCR GHCR GitHub Container Registry, GitHub's hosted service for storing and distributing OCI-compatible container images, giving cyber tools a versioned, access-controlled image store tied directly to a GitHub repository. .
└──▷ GET THIS VERSION
copy
$ git clone --branch v23.04.0 https://github.com/cisagov/Malcolm.git
$ git checkout v23.04.0
└──▷ TRY IT
After upgrading to v23.04.0, reconfigure Malcolm to pull images from GHCR instead of Docker Hub.
copy
$ ./scripts/install.py --configure
Adds tx-rx-secure.sh script as a wrapper around croc for transferring SSL client files between Malcolm and a forwarder using a local-only relay. Not checked yet Migrates container images from Docker Hub to the GitHub Container Registry (GHCR); update docker-compose.yml and re-run ./scripts/install.py --configure to point at the new registry. Not checked yet Automates running install.py --configure on first boot of the Malcolm ISO ISO A widely adopted international standards body that publishes technical specifications; cyber tools cite ISO standards to signal compliance with recognized benchmarks for quality, security, or interoperability. . Not checked yet Upgrades Zeek to v5.2.0, fluent bit to v2.0.10, and NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. to v3.4.7. Not checked yet
4 details in Everything
└──▷ BREAKING ON UPGRADE
! Container images are now pulled from GHCR instead of Docker Hub. Back up docker-compose.yml and docker-compose-standalone.yml, replace them with the files from v23.04.0, and re-run ./scripts/install.py --configure or existing deployments will pull from the old registry.
Malcolm v23.03.0 adds a GUI GUI A graphical user interface, controls such as windows, buttons and menus. It lets people use software visually rather than entering commands. Configure Malcolm launcher, bro-simple-scan integration, and NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. restore logic for demos.
└──▷ GET THIS VERSION
copy
$ git clone --branch v23.03.0 https://github.com/cisagov/Malcolm.git
$ git checkout v23.03.0
└──▷ TRY IT
Reconfigure a running Malcolm ISO ISO A widely adopted international standards body that publishes technical specifications; cyber tools cite ISO standards to signal compliance with recognized benchmarks for quality, security, or interoperability. installation interactively without dropping to the terminal manually.
copy
$ ./scripts/install.py --configure
Adds a Configure Malcolm menu item under the GTK GTK A cross-platform widget toolkit maintained by the GNOME project for building graphical user interfaces in C, with bindings for many languages, giving cyber tools a native desktop UI without writing platform-specific rendering code. Internet menu and a top-panel launcher that runs ./scripts/install.py --configure in full screen on ISO-installed Malcolm. Not checked yet Adds NetBox restore logic to reset_and_auto_populate.sh for demo and presentation workflows. Not checked yet Replaces Zeek's misc/scan.zeek with ncsa/bro-simple-scan for improved scan detection coverage. Not checked yet Enables offline-capable file scanners by default in install.py --configure. Not checked yet Updates Arkime to v4.2.0, OpenSearch OpenSearch An open-source search and analytics engine, forked from Elasticsearch by AWS in 2021, that lets cyber tools store, query, and visualize large volumes of log or event data without licensing restrictions. and OpenSearch Dashboards to 2.6.0, Logstash to v8.6.1, Beats to v8.6.2, Zeek to v5.0.7, and Capa to v5.0.0. Not checked yet
5 details in Everything
Malcolm v23.02.0 adds NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. inventory-vs-traffic comparison dashboards, backup/restore scripts, and configurable dark mode.
└──▷ GET THIS VERSION
copy
$ git clone --branch v23.02.0 https://github.com/cisagov/Malcolm.git
$ git checkout v23.02.0
└──▷ TRY IT
Scaffold the boilerplate needed to integrate a custom Zeek script's logs into Malcolm's pipeline.
copy
$ python3 zeek_script_to_malcolm_boilerplate.py
Tail the last 50 lines of Malcolm logs when troubleshooting a specific container.
copy
$ python3 script/logs -n 50
Adds netbox-backup and netbox-restore scripts to control.py for NetBox database and media backup and restore. Not checked yet Adds zeek_script_to_malcolm_boilerplate.py script to automate adding new Zeek logs to Malcolm. Not checked yet Adds -n argument to script/logs akin to tail -n for controlling log output length. Not checked yet Adds related.device_name field for normalization and pivoting across network data. Not checked yet Adds Zeek Known Summary and Asset Interaction Analysis dashboards for visualizing uninventoried devices and services versus NetBox inventory. Not checked yet
+8 more
show less
Adds Uninventoried Internal Assets and Uninventoried Observed Services views to Arkime for comparing observed traffic against NetBox inventory. Not checked yet Adds default device roles and service templates for initial NetBox population. Not checked yet Adds third-party OpenSearch OpenSearch An open-source search and analytics engine, forked from Elasticsearch by AWS in 2021, that lets cyber tools store, query, and visualize large volumes of log or event data without licensing restrictions. Dashboards custom visualization component lguillaud/osd_transform_vis (Transform plugin). Not checked yet Supports configurable dark mode for OpenSearch Dashboards. Not checked yet Sets state:storeInSessionStorage to true for OpenSearch Dashboards, enabling complex visualizations with the Vega and Transform plugins. Not checked yet Allows NetBox in Malcolm's read-only configuration. Not checked yet Replaces related.segment with ECS ECS Elastic Common Schema, an open specification maintained by Elastic that defines a standard field naming convention for log and event data, letting cyber tools share and correlate records without per-source field mapping. network.name field for network segment normalization. Not checked yet Expands OPCUA-Binary parser dashboard to account for major additions to the icsnpp-opcua-binary parser. Not checked yet
13 details in Everything
└──▷ BREAKING ON UPGRADE
! related.segment has been removed in favor of ECS network.name — any saved searches, dashboards, or pipelines referencing related.segment will break on upgrade.
Malcolm v23.01.0 adds NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. -powered traffic enrichment, expanded YARA rules, and new EtherNet/IP fields.
└──▷ GET THIS VERSION
copy
$ git clone --branch v23.01.0 https://github.com/cisagov/Malcolm.git
$ git checkout v23.01.0
Enriches network traffic metadata via NetBox lookups, correlating captured traffic with network inventory data. Not checked yet Adds bartblaze/Yara-rules as an additional YARA rule source for file scanning. Not checked yet Supports new fields in the EtherNet/IP / CIP parser for broader OT/ICS ICS Industrial Control Systems — hardware and software that monitor and control physical processes like power grids, pipelines, and manufacturing lines, making them a target for cyber tools focused on operational technology environments. protocol coverage. Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! The host-map.txt and cidr-map.txt files for host and subnet name assignment have been removed; use the net-map.json file or NetBox instead.! MAC address MAC address A hardware-address identifier used on a local network, such as Ethernet or Wi-Fi. It identifies a network interface for delivery on that link, rather than routing across the internet. to host name mapping for host and subnet name assignment has been removed.
Malcolm v6.4.3 adds NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. Device Type Library auto-import and new install.py --configure prompts for storage and PCAP PCAP A packet capture, recorded network packets that can be inspected later. Analysts use it to reconstruct communication and investigate protocol behavior or suspicious traffic. management.
└──▷ GET THIS VERSION
copy
$ git clone --branch v6.4.3 https://github.com/cisagov/Malcolm.git
$ git checkout v6.4.3
Adds --configure prompts to install.py for specifying alternative storage locations for PCAP files, Zeek logs, and OpenSearch OpenSearch An open-source search and analytics engine, forked from Elasticsearch by AWS in 2021, that lets cyber tools store, query, and visualize large volumes of log or event data without licensing restrictions. indices. Not checked yet Adds --configure prompt to install.py asking whether Arkime should manage uploaded PCAP files. Not checked yet Imports the NetBox Device Type Library on first run to auto-populate manufacturers, device types, models, and modules. Not checked yet
3 details in Everything
Malcolm v6.4.1 adds PCAP PCAP A packet capture, recorded network packets that can be inspected later. Analysts use it to reconstruct communication and investigate protocol behavior or suspicious traffic. compression for Arkime capture on Hedgehog Linux and automatic NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. host/subnet mapping creation.
└──▷ GET THIS VERSION
copy
$ git clone --branch v6.4.1 https://github.com/cisagov/Malcolm.git
$ git checkout v6.4.1
Enables configuration of Arkime capture to use PCAP compression on Hedgehog Linux. Not checked yet Automatically creates corresponding net-map.json / Host and Subnet Name Mapping entries in NetBox when applicable. Not checked yet
2 details in Everything
Malcolm v6.4.0 adds initial NetBox NetBox An open-source network infrastructure management platform maintained by the NetBox Labs community, used to model IP addresses, devices, and topology so cyber tools can query a live source of truth about the environment. integration and s7comm_upload_download.log support alongside expanded install.py options.
└──▷ GET THIS VERSION
copy
$ git clone --branch v6.4.0 https://github.com/cisagov/Malcolm.git
$ git checkout v6.4.0
└──▷ TRY IT
After upgrading, re-run the configuration script to populate new required environment variables without breaking your existing docker-compose setup.
copy
$ ./scripts/auth_setup && ./scripts/install.py --configure
Adds s7comm_upload_download.log support for Zeek-based S7comm upload/download session logging. Not checked yet Surfaces more options in install.py --configure for expanded environment configuration control. Not checked yet Adds initial NetBox (network infrastructure resource modeling) integration. Not checked yet Allows optional PCAP PCAP A packet capture, recorded network packets that can be inspected later. Analysts use it to reconstruct communication and investigate protocol behavior or suspicious traffic. compression on Hedgehog via the updated Arkime v4.0.1 component. Not checked yet
4 details in Everything
└──▷ BREAKING ON UPGRADE
! New environment variables are required: run ./scripts/auth_setup and ./scripts/install.py --configure after upgrading to ensure docker-compose files are updated correctly.
Malcolm v6.3.0 adds remote OpenSearch OpenSearch An open-source search and analytics engine, forked from Elasticsearch by AWS in 2021, that lets cyber tools store, query, and visualize large volumes of log or event data without licensing restrictions. cluster support, S7comm Plus protocol parsing, and raises the field limit to 5,000.
└──▷ GET THIS VERSION
copy
$ git clone --branch v6.3.0 https://github.com/cisagov/Malcolm.git
$ git checkout v6.3.0
└──▷ TRY IT
Point Malcolm at an existing remote OpenSearch cluster instead of its local container — run both configuration scripts to set the required environment variables.
copy
$ ./scripts/auth_setup && ./scripts/install.py --configure
Supports a remote OpenSearch instance or cluster as an alternative to Malcolm's local containerized instance, configured via ./scripts/auth_setup and ./scripts/install.py --configure. Not checked yet Adds S7comm Plus protocol support and replaces the Amazon S7comm parser with icsnpp-s7comm. Not checked yet Increases the maximum number of indexed fields from 3,000 to 5,000. Not checked yet Adds documentation and convenience scripts for ingesting third-party logs, including basic parsing and normalizing of Fluent-Bit's Windows event logs. Not checked yet Delivers major improvements to the OPC UA Binary parser and its supporting dashboards. Not checked yet
+2 more
show less
Standardizes configuration and authentication for both primary and secondary remote OpenSearch instances, including automatic creation of index templates on secondary instances. Not checked yet Expands normalization of network.direction (ECS ECS Elastic Common Schema, an open specification maintained by Elastic that defines a standard field naming convention for log and event data, letting cyber tools share and correlate records without per-source field mapping. field) in place of using tags. Not checked yet
7 details in Everything
└──▷ BREAKING ON UPGRADE
! The changes for remote OpenSearch support require modifications to files used by docker-compose; existing deployments must run ./scripts/auth_setup and ./scripts/install.py --configure to set the required new environment variables, or the stack will not function correctly after upgrade.
Malcolm v6.2.0 splits Zeek/Suricata into live-capture and PCAP PCAP A packet capture, recorded network packets that can be inspected later. Analysts use it to reconstruct communication and investigate protocol behavior or suspicious traffic. -upload containers and adds Suricata rule update cron jobs.
└──▷ GET THIS VERSION
copy
$ git clone --branch v6.2.0 https://github.com/cisagov/Malcolm.git
$ git checkout v6.2.0
└──▷ TRY IT
Reconfigure a standalone Malcolm instance after upgrading to set the new live-capture environment variables and choose whether to expose the SFTP SFTP SSH File Transfer Protocol, a file transfer standard built on top of SSH that provides encrypted upload, download, and remote file management; cyber tools use it to move files or exfiltrate data over an authenticated, encrypted channel. port externally.
copy
$ ./scripts/auth_setup && ./scripts/install.py --configure
Splits Zeek and Suricata each into two containers — zeek/zeek-live and suricata/suricata-live — separating live traffic capture from uploaded PCAP analysis. Not checked yet Adds option to disable capture interface hardware offloading and adjust ring buffer sizes for standalone Malcolm live capture. Not checked yet Adds Suricata rule update cron jobs to keep detection rules current automatically. Not checked yet Uses zeekdeploy.sh on both Hedgehog and the Malcolm zeek docker images to configure and run Zeek consistently across deployments. Not checked yet Adds install.py --configure prompt to control whether the SFTP port is exposed to external hosts. Not checked yet
+1 more
show less
Adds documentation in the form of comments to all docker-compose file variables. Not checked yet
6 details in Everything
└──▷ BREAKING ON UPGRADE
! The new zeek-live and suricata-live containers require new environment variables in the docker-compose files — run ./scripts/auth_setup and ./scripts/install.py --configure before upgrading or existing configurations will be missing required variables.
Malcolm v6.1.0 adds a TCP TCP A network protocol that delivers a reliable, ordered stream of bytes between two endpoints. It detects lost data and retransmits it. log-ingestion endpoint, upgrades to OpenSearch OpenSearch An open-source search and analytics engine, forked from Elasticsearch by AWS in 2021, that lets cyber tools store, query, and visualize large volumes of log or event data without licensing restrictions. 2.1.0, and replaces Beats with Fluent Bit on Hedgehog Linux.
└──▷ GET THIS VERSION
copy
$ git clone --branch v6.1.0 https://github.com/cisagov/Malcolm.git
$ git checkout v6.1.0
Adds an optionally exposed TCP input endpoint to Malcolm (disabled by default) to allow ingestion of third-party logs not natively supported by Malcolm. Not checked yet Replaces most Beats instances on Hedgehog Linux with Fluent Bit for resource-utilization monitoring, with recreated dashboards referencing those metrics. Not checked yet Replaces the Auditbeat file integrity checking module with AIDE on Hedgehog Linux. Not checked yet Upgrades OpenSearch and OpenSearch Dashboards to v2.1.0, enabling UI-based index state management and snapshot management. Not checked yet Upgrades Zeek to v5.0.0 with built-in Spicy and the Spicy Zeek plugin. Not checked yet
+2 more
show less
Composes Malcolm's OpenSearch index template from the latest Elastic Common Schema (ECS ECS Elastic Common Schema, an open specification maintained by Elastic that defines a standard field naming convention for log and event data, letting cyber tools share and correlate records without per-source field mapping. ) release on initialization. Not checked yet Improves APIs for listing fields and indices. Not checked yet
7 details in Everything
└──▷ BREAKING ON UPGRADE
! Old environment variable-configured Index State Management code has been removed; ISM policies must now be managed through the OpenSearch Dashboards UI.
Malcolm v6.0.0 adds Suricata as a full network-traffic data source alongside Zeek and Arkime, plus GENISYS protocol support.
└──▷ GET THIS VERSION
copy
$ git clone --branch v6.0.0 https://github.com/cisagov/Malcolm.git
$ git checkout v6.0.0
Adds event.provider (values: arkime, zeek, suricata) and event.dataset (e.g., session, conn, alert) fields across all data sources to enable precise cross-source filtering. Not checked yet Extends the Malcolm 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. to support POST operations for all calls that accept a filter argument, allowing filters to be expressed as JSON objects. Not checked yet Incorporates Suricata as a data source for network traffic analysis in both Malcolm and Hedgehog Linux alongside Zeek and Arkime. Not checked yet Adds support for the GENISYS ICS ICS Industrial Control Systems — hardware and software that monitor and control physical processes like power grids, pipelines, and manufacturing lines, making them a target for cyber tools focused on operational technology environments. protocol via the icsnpp-genisys plugin. Not checked yet Reworks the Overview , Security Overview , Zeek Notices , and Signatures dashboards. Not checked yet
5 details in Everything
└──▷ BREAKING ON UPGRADE
! Extensive remapping of Zeek fields to align with Suricata naming conventions breaks backwards compatibility with data indexed under v5.x; a fresh install is strongly encouraged — upgrading from a previous release is not supported.
Malcolm v5.2.11 improves reverse-proxy configuration workflow, adds event.provider/event.dataset fields in Arkime, and upgrades core components.
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.2.11 https://github.com/cisagov/Malcolm.git
$ git checkout v5.2.11
Assigns and displays both event.provider and event.dataset fields in Arkime session views. Not checked yet Improves the workflow for configuring Malcolm to run behind a reverse proxy (Caddy, Traefik, etc.). Not checked yet The install.py script now uses the pythondialog module for interactive setup on Linux when available. Not checked yet Adds a Dashboards link in the footer of Arkime's interface. Not checked yet Shows PCAP PCAP A packet capture, recorded network packets that can be inspected later. Analysts use it to reconstruct communication and investigate protocol behavior or suspicious traffic. download controls in session details only when a PCAP actually backs the session document. Not checked yet
5 details in Everything
Malcolm v5.2.10 restores the zeek.cip_io.io_data field and adds a malcolmmonitor convenience function in ISO ISO A widely adopted international standards body that publishes technical specifications; cyber tools cite ISO standards to signal compliance with recognized benchmarks for quality, security, or interoperability. environments.
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.2.10 https://github.com/cisagov/Malcolm.git
$ git checkout v5.2.10
Adds malcolmmonitor convenience bash function into the Malcolm ISO-installed environment. Not checked yet
1 detail in Everything
Malcolm v5.2.8 adds 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 mounting support in ISO ISO A widely adopted international standards body that publishes technical specifications; cyber tools cite ISO standards to signal compliance with recognized benchmarks for quality, security, or interoperability. -installed environments via the Thunar GUI GUI A graphical user interface, controls such as windows, buttons and menus. It lets people use software visually rather than entering commands. .
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.2.8 https://github.com/cisagov/Malcolm.git
$ git checkout v5.2.8
Includes gvfs-backends package in ISO-installed environments to allow mounting SMB shares in the Thunar GUI. Not checked yet
1 detail in Everything
Malcolm v5.2.7 adds an API webhook alerting destination, non-HTTPS HTTPS HTTP carried over an encrypted TLS connection. It protects traffic in transit and lets a browser verify the server's certificate. nginx-proxy mode, and Amazon Linux 2 demo scripts.
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.2.7 https://github.com/cisagov/Malcolm.git
$ git checkout v5.2.7
Adds an API webhook that can be used as an Alerting destination, indexing triggered alerts back into OpenSearch OpenSearch An open-source search and analytics engine, forked from Elasticsearch by AWS in 2021, that lets cyber tools store, query, and visualize large volumes of log or event data without licensing restrictions. as session records. Not checked yet Adds example Alerting monitor and destination configuration using the API webhook. Not checked yet Adds ability to run Malcolm's nginx-proxy container in non-HTTPS mode, useful when operating behind a third-party reverse proxy such as Traefik or Caddy. Not checked yet Adds example scripts and Vagrantfile for configuring and running Malcolm in a read-only or demo mode on Amazon Linux 2 (AWS). Not checked yet Removes the performance-analyzer plugin from the OpenSearch container to free up resources. Not checked yet
5 details in Everything
Malcolm v5.2.6 adds HTTP filename enrichment and improved service filtering in convenience scripts.
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.2.6 https://github.com/cisagov/Malcolm.git
$ git checkout v5.2.6
└──▷ TRY IT
Filter live log output to a single Malcolm service instead of tailing all containers at once.
Supports filtering the logs and status convenience scripts to a particular service. Not checked yet Adds the http-more-files-names plugin to populate files.log filenames entries for HTTP requests. Not checked yet
2 details in Everything
Malcolm v5.2.5 adds automatic Zeek intelligence generation from MISP/TAXII TAXII A protocol for sharing threat intelligence over HTTPS, commonly carrying STIX data. It lets tools retrieve and exchange intelligence from compatible services. , date-based indicator filtering, and a new sensor monitoring utility.
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.2.5 https://github.com/cisagov/Malcolm.git
$ git checkout v5.2.5
└──▷ TRY IT
Monitor Hedgehog Linux sensor services, disk space, and logs in real time from the sensor appliance.
Adds sensormonitor convenience function to Hedgehog Linux for monitoring services, disk space, and logs. Not checked yet Automatically generates Zeek intelligence indicators from MISP feeds. Not checked yet Performs autogeneration of Zeek intel files from TAXII/MISP feeds in a multithreaded manner. Not checked yet Allows filtering TAXII/MISP indicators by date (e.g., include only those created/modified in the last n days). Not checked yet Adds intelligence hits as a new severity-ranked category. Not checked yet
+1 more
show less
Highlights intel sources more clearly in the dashboard. Not checked yet
6 details in Everything
Malcolm v5.2.4 auto-generates Zeek intelligence indicators from STIX/TAXII STIX/TAXII STIX is an OASIS-maintained JSON schema for expressing threat intelligence objects; TAXII is the companion HTTP protocol for exchanging them, giving cyber tools a vendor-neutral way to share indicators and threat data. and improves MAC/OUI field grouping.
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.2.4 https://github.com/cisagov/Malcolm.git
$ git checkout v5.2.4
Automatically generate Zeek intelligence indicators from STIX STIX Structured Threat Information Expression, a standard format for describing threats, indicators and their relationships. It helps organizations exchange threat intelligence in a usable form. /TAXII TAXII A protocol for sharing threat intelligence over HTTPS, commonly carrying STIX data. It lets tools retrieve and exchange intelligence from compatible services. feeds. Not checked yet Groups MAC addresses MAC addresses A hardware-address identifier used on a local network, such as Ethernet or Wi-Fi. It identifies a network interface for delivery on that link, rather than routing across the internet. and OUI (vendors) into related.mac and related.oui for easier searching across all fields. Not checked yet Improves default anomaly detectors. Not checked yet
3 details in Everything
Malcolm v5.2.2 adds a new /document/ API endpoint and filter support on /agg/ and /document/.
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.2.2 https://github.com/cisagov/Malcolm.git
$ git checkout v5.2.2
Adds /document/ API endpoint for document-level queries. Not checked yet Adds filter parameter to the /agg/ and /document/ API endpoints. Not checked yet Changes Zeek intelligence file location from /opt/zeek/share/zeek/site/intel to /opt/sensor/sensor_ctl/zeek/intel on Hedgehog Linux so files persist across reboots. Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! Zeek intelligence files must now be placed at /opt/sensor/sensor_ctl/zeek/intel instead of /opt/zeek/share/zeek/site/intel on Hedgehog Linux; files at the old path will no longer be loaded.
Malcolm v5.2.0 adds Zeek Intelligence Framework support, an OPCUA Binary protocol parser, and new /fields/ and /agg/ API improvements.
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.2.0 https://github.com/cisagov/Malcolm.git
$ git checkout v5.2.0
Adds /fields/ API endpoint to list available fields. Not checked yet Expands the /agg/ API endpoint to support bucketing multiple fields in a single request. Not checked yet Integrates the Zeek Intelligence Framework, loading threat-intel files (IP addresses, URLs, file names, hashes, email addresses) from ./zeek/intel subdirectories at startup — subdirectories with __load__.zeek are @load-ed as-is; others are loaded via redef Intel::read_files. Not checked yet Adds a new OPCUA Binary protocol parser for Zeek (cisagov/icsnpp-opcua-binary) with a corresponding dashboard. Not checked yet Sets ecs.provider to arkime for logs from Arkime's capture to enable categorization by log source. Not checked yet
+1 more
show less
Adds ECS ECS Elastic Common Schema, an open specification maintained by Elastic that defines a standard field naming convention for log and event data, letting cyber tools share and correlate records without per-source field mapping. normalization to the related.hosts field for all applicable protocols. Not checked yet
6 details in Everything
Malcolm v5.1.0 introduces the groundwork for a new 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. for querying Malcolm.
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.1.0 https://github.com/cisagov/Malcolm.git
$ git checkout v5.1.0
Malcolm v5.0.0 replaces Elasticsearch/Kibana with OpenSearch OpenSearch An open-source search and analytics engine, forked from Elasticsearch by AWS in 2021, that lets cyber tools store, query, and visualize large volumes of log or event data without licensing restrictions. , unlocking ML anomaly detection, alerting, and reporting at no extra cost.
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.0.0 https://github.com/cisagov/Malcolm.git
$ git checkout v5.0.0
Switches the search and analytics backend from Elasticsearch/Kibana to OpenSearch, enabling machine learning anomaly detection, alerting, and reporting that previously required paid Elastic.co premium subscriptions. Not checked yet
1 detail in Everything
└──▷ BREAKING ON UPGRADE
! The migration from Elasticsearch to OpenSearch is backwards-incompatible — upgrading from v4.x is not supported; a fresh install is required.
Malcolm v4.0.1 adds OSPF protocol analysis via the zeek-spicy-ospf package with matching visualizations.
└──▷ GET THIS VERSION
copy
$ git clone --branch v4.0.1 https://github.com/cisagov/Malcolm.git
$ git checkout v4.0.1
Malcolm v4.0.0 migrates to Elastic Common Schema field naming, renaming indices and many fields across the entire data store.
└──▷ GET THIS VERSION
copy
$ git clone --branch v4.0.0 https://github.com/cisagov/Malcolm.git
$ git checkout v4.0.0
Renames Elasticsearch session indices from sessions2-* to arkime-sessions3-*, aligning with ECS ECS Elastic Common Schema, an open specification maintained by Elastic that defines a standard field naming convention for log and event data, letting cyber tools share and correlate records without per-source field mapping. conventions. Not checked yet Migrates Zeek-specific field names to ECS or ECS-inspired names (e.g., zeek_foo.bar becomes zeek.foo.bar), updating all related parsing code and dashboard definitions. Not checked yet Adds GitHub Actions GitHub Actions GitHub's built-in CI/CD system that runs automated workflows triggered by repository events, letting cyber tools automate testing, building, and releasing without managing separate pipeline infrastructure. workflow files to build Docker images and installer ISOs for the sensor (Hedgehog) and Malcolm. Not checked yet Improves 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. parser to provide greater detail from observed LDAP searches. Not checked yet Replaces logstash-filter-ieee_oui with a genericized internal implementation in logstash/ruby/mac_lookup.rb for mapping MAC addresses MAC addresses A hardware-address identifier used on a local network, such as Ethernet or Wi-Fi. It identifies a network interface for delivery on that link, rather than routing across the internet. to vendor OUIs. Not checked yet
5 details in Everything
└──▷ BREAKING ON UPGRADE
! Old network session data stored in sessions2-* indices will not be visible; indices are now named arkime-sessions3-*.! Many field names have changed to ECS-aligned names (e.g., zeek_foo.bar becomes zeek.foo.bar); custom saved dashboards and bookmarks to Kibana or Arkime visualizations must be updated accordingly.! Upgrading from previous versions of Malcolm to v4.0.0+ is not supported; a fresh install is recommended.
Malcolm v3.4.0 adds STUN protocol support, improved ICS ICS Industrial Control Systems — hardware and software that monitor and control physical processes like power grids, pipelines, and manufacturing lines, making them a target for cyber tools focused on operational technology environments. traffic tagging, and major component version upgrades.
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.4.0 https://github.com/cisagov/Malcolm.git
$ git checkout v3.4.0
Adds parser support and dashboard for the STUN (Session Traversal Utilities for NAT) protocol via the Zeek Spicy analyzer. Not checked yet Logs from known ICS protocols now have ics added to the tags field for clearer ICS traffic identification. Not checked yet Logs identified by ICS best guess lookups now have ics_best_guess added to the tags field. Not checked yet Augments ICS best guess lookups with a MAC address MAC address A hardware-address identifier used on a local network, such as Ethernet or Wi-Fi. It identifies a network interface for delivery on that link, rather than routing across the internet. lookup table of ICS hardware vendors. Not checked yet Upgrades Arkime to v3.3.1 (from v2.7.1), bringing a major version jump in the core packet capture packet capture A packet capture, recorded network packets that can be inspected later. Analysts use it to reconstruct communication and investigate protocol behavior or suspicious traffic. and search component. Not checked yet
+5 more
show less
Upgrades Zeek to v4.1.1 (from v4.0.4), including Zeek 4.1 feature release capabilities. Not checked yet Upgrades Spicy to v1.3.0 (from v1.2.1) for protocol parser development. Not checked yet Replaces LXDE desktop environment with XFCE in ISO ISO A widely adopted international standards body that publishes technical specifications; cyber tools cite ISO standards to signal compliance with recognized benchmarks for quality, security, or interoperability. images. Not checked yet Upgrades base OS for ISO images from Debian v10 to Debian v11. Not checked yet Adds GitHub Actions GitHub Actions GitHub's built-in CI/CD system that runs automated workflows triggered by repository events, letting cyber tools automate testing, building, and releasing without managing separate pipeline infrastructure. workflows for building Malcolm Docker images and pushing them to GHCR GHCR GitHub Container Registry, GitHub's hosted service for storing and distributing OCI-compatible container images, giving cyber tools a versioned, access-controlled image store tied directly to a GitHub repository. . Not checked yet
10 details in Everything
└──▷ BREAKING ON UPGRADE
! Various fields have been renamed to align with Arkime's gradual adoption of the Elastic Common Schema — existing queries, dashboards, or saved searches referencing the old field names may break on upgrade.
Malcolm v3.3.1 adds OMIGOD detection and ELF ELF The standard binary format for executables, shared libraries, and object files on Linux and most Unix-like systems, giving cyber tools a predictable structure to parse, instrument, or analyze compiled code. binary scanning via updated capa and Zeek.
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.3.1 https://github.com/cisagov/Malcolm.git
$ git checkout v3.3.1
Bumps capa to v3.0.2, adding ELF binary scanning capabilities alongside existing PE analysis. Not checked yet
1 detail in Everything
Malcolm v3.3.0 adds automatic anomaly detectors for connections, file transfers, and protocols, plus a configurable Severity dashboard.
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.3.0 https://github.com/cisagov/Malcolm.git
$ git checkout v3.3.0
Automatically creates anomaly detectors on Kibana initialization for connection size, file transfer MIME type, and action/result by application protocol. Not checked yet Adds configurable event severity scoring and a new Severity dashboard. Not checked yet
2 details in Everything
Malcolm v3.2.0 adds Best Guess ICS ICS Industrial Control Systems — hardware and software that monitor and control physical processes like power grids, pipelines, and manufacturing lines, making them a target for cyber tools focused on operational technology environments. protocol fingerprinting via port/transport mapping and exposes concurrency controls for ClamAV, Yara, and Capa.
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.2.0 https://github.com/cisagov/Malcolm.git
$ git checkout v3.2.0
Adds CLAMD_MAX_REQUESTS, YARA_MAX_REQUESTS, and CAPA_MAX_REQUESTS environment variables to configure the number of concurrent requests for ClamAV scanning, Yara, and Capa. Not checked yet Adds Best Guess fingerprinting for ICS protocols, using a mapping table (zeek/config/guess_ics_map.txt) and Zeek script (zeek/config/guess.zeek) to categorize traffic by transport protocol and port when full parser support is unavailable, with vendor categorization where possible. Not checked yet
2 details in Everything
Malcolm v3.1.0 adds EtherCAT ICS ICS Industrial Control Systems — hardware and software that monitor and control physical processes like power grids, pipelines, and manufacturing lines, making them a target for cyber tools focused on operational technology environments. protocol support and VPN VPN A virtual private network, an encrypted tunnel between devices or networks. It carries traffic across another network as though the endpoints had a private connection. protocol detection for IPsec IPsec A suite of IETF protocols that authenticate and encrypt IP packets at the network layer, giving cyber tools a standards-based way to build VPNs or secure host-to-host tunnels without modifying applications. , OpenVPN, and WireGuard WireGuard A modern VPN protocol and Linux kernel module, maintained as an open-source project, that establishes encrypted tunnels using minimal code and fast cryptography, giving cyber tools a lightweight, high-performance transport layer. .
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.1.0 https://github.com/cisagov/Malcolm.git
$ git checkout v3.1.0
Adds EtherCAT ICS protocol support via the icsnpp-ethercat Zeek plugin. Not checked yet Detects VPN protocols IPsec, OpenVPN, and WireGuard via Spicy-based analyzers. Not checked yet Adds and updates Kibana dashboards for newly-supported network protocols. Not checked yet
3 details in Everything
Malcolm v3.0.1 upgrades ODFE to v1.13.0, gaining Reporting and Historical Anomaly Detection, and hardens Elasticsearch exposure defaults.
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.0.1 https://github.com/cisagov/Malcolm.git
$ git checkout v3.0.1
Elasticsearch port 9200 is no longer exposed by default and must now be explicitly enabled during install.py -c. Not checked yet Upgrades Open Distro for Elasticsearch to v1.13.0 (based on Elastic 7.10.2), adding Reporting and Historical Data Anomaly Detection capabilities. Not checked yet Removes port 8443 for file upload; uploads now use /upload over the standard HTTPS HTTPS HTTP carried over an encrypted TLS connection. It protects traffic in transit and lets a browser verify the server's certificate. port only. Not checked yet Adds an Arkime link to Kibana dashboards' navigation pane. Not checked yet Populates /etc/os-release with build/release version information on ISO ISO A widely adopted international standards body that publishes technical specifications; cyber tools cite ISO standards to signal compliance with recognized benchmarks for quality, security, or interoperability. -installed Malcolm and Hedgehog Linux. Not checked yet
5 details in Everything
└──▷ BREAKING ON UPGRADE
! Port 8443 for file upload is removed; all uploads must now go through /upload on the standard HTTPS port.! Elasticsearch port 9200 is no longer exposed by default; existing setups relying on it must re-enable it explicitly via install.py -c.
Malcolm v3.0.0 moves to Open Distro for Elasticsearch 7.10.0, gaining real-time anomaly detection and Index Management.
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.0.0 https://github.com/cisagov/Malcolm.git
$ git checkout v3.0.0
└──▷ TRY IT
Re-run configuration after upgrading to apply new Open Distro-compatible settings before starting Malcolm v3.0.0.
copy
$ python3 install.py --configure
Replaces Elasticsearch/Kibana base (7.6.2) with Open Distro for Elasticsearch (based on Elastic 7.10.0), enabling the open-source plugin ecosystem from Open Distro. Not checked yet Adds Real Time Anomaly Detection via the Open Distro Anomaly Detection plugin for both Elasticsearch and Kibana components. Not checked yet Replaces the Kibana elastalert plugin with the Open Distro Alerting plugin for rule-based alerting. Not checked yet Replaces Elasticsearch curator with the Open Distro Index Management plugin for index lifecycle control. Not checked yet Replaces Kibana comments plugin with Open Distro Notebooks for collaborative annotation. Not checked yet
+1 more
show less
Reduces Malcolm startup time significantly, particularly for the Logstash container. Not checked yet
6 details in Everything
└──▷ BREAKING ON UPGRADE
! The underlying Elasticsearch and Kibana Docker images have changed from Elastic.co 7.6.2 to Open Distro for Elasticsearch 7.10.0; existing Kibana saved objects, alerts, and index management policies are not automatically migrated — manual backup and migration is required before running v3.0.0.! The Kibana comments plugin is replaced by Open Distro Notebooks; any existing comments will not be migrated automatically.! The Kibana elastalert plugin is replaced by the Open Distro Alerting plugin; existing elastalert rules must be manually recreated.! Elasticsearch curator is replaced by the Open Distro Index Management plugin; existing curator jobs/configurations must be manually migrated.! The Sankey visualization plugin and the Kibana drill-down/Moloch pivot plugin have been removed due to compatibility issues and are temporarily unavailable.! Re-running install.py --configure is required before starting Malcolm v3.0.0.
Malcolm v2.6.1 adds TFTP TFTP Trivial File Transfer Protocol, a minimal UDP-based file transfer protocol standardized in RFC 1350, used by cyber tools when simplicity and low overhead matter more than authentication or error recovery. protocol support with Zeek parsing, Logstash, Arkime WISE, and Kibana dashboards, plus browser-based extracted-files access.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.6.1 https://github.com/cisagov/Malcolm.git
$ git checkout v2.6.1
Adds TFTP protocol support via a Zeek spicy-tftp parser with corresponding Logstash parsing, Arkime WISE integration, and Kibana dashboards. Not checked yet Provides browser-based access to the zeek/extracted-files directory. Not checked yet Provides more fine-tuned controls for Zeek's node.cfg in the Hedgehog sensor. Not checked yet
3 details in Everything
Malcolm v2.6.0 adds BSAP IP and BSAP Serial ICS ICS Industrial Control Systems — hardware and software that monitor and control physical processes like power grids, pipelines, and manufacturing lines, making them a target for cyber tools focused on operational technology environments. parsers and replaces Amazon ICS parsers with INL/CISA-developed ones for BACnet BACnet A communication protocol for building automation systems, standardized as ASHRAE 135, covering HVAC, lighting, and access control devices. Cyber tools use it to discover and interact with building infrastructure on IP or serial networks. and Ethernet/IP.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.6.0 https://github.com/cisagov/Malcolm.git
$ git checkout v2.6.0
Adds new Zeek parsers for the BSAP ICS protocol: BSAP IP (zeek_bsap_ip_parser) and BSAP Serial (zeek_bsap_serial_parser) via the ICSNPP project. Not checked yet Replaces Amazon ICS Zeek parsers for BACnet and Ethernet/IP with Idaho National Lab / CISA ICSNPP parsers (zeek_bacnet_parser, zeek_enip_parser). Not checked yet Incorporates updated ICSNPP Zeek parsers for DNP3 DNP3 A serial and TCP/IP communication protocol used in industrial control systems, especially power grids and water utilities, to let control software poll and command field devices like sensors and switches. (zeek_dnp3_parser) and Modbus (zeek_modbus_parser) ICS protocols. Not checked yet
3 details in Everything
Malcolm v2.4.2 adds periodic auto-updates for Yara and Capa rules and bumps Arkime to 2.7.1.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.4.2 https://github.com/cisagov/Malcolm.git
$ git checkout v2.4.2
Adds periodic automatic updates for Yara (signature-base) and Capa rules alongside existing ClamAV rule updates for file scanners. Not checked yet Upgrades Arkime (formerly Moloch) to 2.7.1 with related user-facing code and documentation updated. Not checked yet
2 details in Everything
Malcolm v2.4.0 adds Capa as an optional extracted file scanner and a Zerologon detection plugin for Zeek.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.4.0 https://github.com/cisagov/Malcolm.git
$ git checkout v2.4.0
Malcolm v2.3.0 adds concurrent file scanners and Yara integration with Signature-Base ruleset for carved file analysis.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.3.0 https://github.com/cisagov/Malcolm.git
$ git checkout v2.3.0
└──▷ TRY IT
Drop custom Yara rules into the Malcolm directory so carved files are scanned against your own signatures alongside the default Signature-Base ruleset.
copy
$ cp my_custom_rules.yar <malcolm_dir>/yara/rules/
Adds Yara as a carved file scanner, feeding results into signatures.log, with Florian Roth's Signature-Base ruleset enabled by default and support for custom rules placed under yara/rules in the Malcolm directory. Not checked yet Enables multiple carved file scanners to run concurrently (previously limited to one at a time). Not checked yet
2 details in Everything
Malcolm v2.2.0 adds Spicy parsing, a WireGuard WireGuard A modern VPN protocol and Linux kernel module, maintained as an open-source project, that establishes encrypted tunnels using minimal code and fast cryptography, giving cyber tools a lightweight, high-performance transport layer. parser, Corelight plugins, and optional ECS ECS Elastic Common Schema, an open specification maintained by Elastic that defines a standard field naming convention for log and event data, letting cyber tools share and correlate records without per-source field mapping. field mapping via LOGSTASH_TO_ECS.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.2.0 https://github.com/cisagov/Malcolm.git
$ git checkout v2.2.0
└──▷ USE IT
Opt in to Elastic Common Schema field mapping for Zeek logs so downstream SIEM SIEM Security information and event management, collecting logs from many systems and correlating events to find suspicious activity. Analysts use it to investigate alerts and incidents. queries use standardised ECS field names.
yaml
copy
x-logstash-variables:
LOGSTASH_TO_ECS: 'true'
Enables or disables Zeek features/parsers at runtime using environment variables. Not checked yet Adds LOGSTASH_TO_ECS : 'true' in x-logstash-variables in docker-compose.yml to map Zeek log fields to Elastic Common Schema (ECS); disabled by default. Not checked yet Adds a WireGuard (Spicy-based) parser for Zeek, with corresponding Logstash parsing for noise.log. Not checked yet Bundles the Spicy parser framework with Zeek. Not checked yet Adds Corelight's callstranger-detector, ripple20, and SIGred Zeek plugins. Not checked yet
+1 more
show less
Adds documentation, scripts, Vagrantfiles, and sample configurations for using Beats to forward host logs to Malcolm. Not checked yet
6 details in Everything
Malcolm v2.1.0 adds Sniffpass/HTTP-attacks Zeek plugins, telnet/rsh/rlogin parsing, new Kibana dashboards, and bidirectional Kibana↔Moloch drilldown.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.1.0 https://github.com/cisagov/Malcolm.git
$ git checkout v2.1.0
Adds zeek-sniffpass plugin (Cybera) to detect cleartext passwords in HTTP POST requests. Not checked yet Adds zeek-httpattacks plugin (Andrew Klaus) to detect noncompliant HTTP requests. Not checked yet Adds telnet, rsh, and rlogin protocol support in Zeek and Logstash parsing/enrichment. Not checked yet Introduces new zeek.result field normalizing success/result/status/error values across protocols. Not checked yet Better normalization of zeek.action field for SNMP SNMP A UDP-based protocol for querying and managing network devices, standardized by the IETF. Cyber tools use it to pull interface stats, topology data, and device state from routers, switches, and servers at scale. , DNP3 DNP3 A serial and TCP/IP communication protocol used in industrial control systems, especially power grids and water utilities, to let control software poll and command field devices like sensors and switches. , and other protocols. Not checked yet
+6 more
show less
New actions and results dashboard in Kibana. Not checked yet Adds sankey diagram visualization in Kibana. Not checked yet Adds network visualization in Kibana. Not checked yet Enables bidirectional drilldown between Kibana and Moloch. Not checked yet Loads all known field mappings at startup in Kibana. Not checked yet Adds more links to external URLs for RFCs, port numbers, and IANA references in Kibana. Not checked yet
11 details in Everything
Malcolm v2.0.5 adds Spicy plugin support and two new Zeek plugins for credential and HTTP-attack detection.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.0.5 https://github.com/cisagov/Malcolm.git
$ git checkout v2.0.5
Adds indices.query.bool.max_clause_count raised to 2048 for Elasticsearch, enabling more complex boolean queries. Not checked yet Builds Spicy plugin alongside Zeek, adding the Spicy protocol-analysis framework to Malcolm's packet-analysis stack. Not checked yet Adds zeek-sniffpass Zeek plugin, enabling detection of credentials passed in cleartext over the network. Not checked yet Adds zeek-httpattacks Zeek plugin, enabling detection of HTTP-based attacks in Zeek logs. Not checked yet Populates zeek.action field from SNMP SNMP A UDP-based protocol for querying and managing network devices, standardized by the IETF. Cyber tools use it to pull interface stats, topology data, and device state from routers, switches, and servers at scale. logs where possible, extending protocol-level action tracking to SNMP traffic. Not checked yet
+1 more
show less
Handles client_software and server_software fields from dhcp.log, surfacing DHCP client/server fingerprinting data. Not checked yet
6 details in Everything
Malcolm now enforces 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. certificate verification when CA certs are present in nginx/ca-trust/.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.0.3 https://github.com/cisagov/Malcolm.git
$ git checkout v2.0.3
└──▷ BREAKING ON UPGRADE
! If one or more CA certificate files are placed in nginx/ca-trust/, Malcolm will now require and verify the LDAP server certificate — connections to domain servers presenting an untrusted or self-signed certificate will fail where they previously succeeded.
Malcolm v2.0.0 adds network map baseline comparison, security overview dashboards, and DGA entropy analysis
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.0.0 https://github.com/cisagov/Malcolm.git
$ git checkout v2.0.0
Adds 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. access to the new network map baseline comparison report for programmatic queries against current vs. historical network topology Not checked yet Adds network map baseline comparison view to visualize logical network topology changes against a previous time frame, using any of Malcolm's 900+ fields as graph node references, with icons for new () and removed () nodes and view filters for all/actual/baseline/new nodes only Not checked yet Adds two new Kibana security overview dashboards: Security Overview (Zeek notices, AV signatures, clear-text password transmission, outdated protocols, geo-traffic, DGA DNS queries, remote access) and ICS/IoT Security Overview (ICS ICS Industrial Control Systems — hardware and software that monitor and control physical processes like power grids, pipelines, and manufacturing lines, making them a target for cyber tools focused on operational technology environments. /IoT IoT A collective label for internet-connected physical devices — sensors, cameras, routers, appliances — that tools target because they run embedded firmware with limited patching and broad network exposure. protocol traffic, external ICS/IoT connections, non-ICS/IoT protocol detection) Not checked yet Adds optional character frequency/entropy analysis on DNS queries and SSL SSL A cryptographic protocol for encrypting network connections, now deprecated in favor of TLS but whose name persists colloquially. Cyber tools reference it when handling HTTPS or other encrypted-channel inspection and termination. certificate server names to detect domain generation algorithm (DGA) hostnames used by malware Not checked yet Adds a user interface for defining host and subnet name assignments Not checked yet
+1 more
show less
Adds logging and Kibana dashboards for tracking user access to Malcolm's own web interfaces (Moloch, Kibana, PCAP PCAP A packet capture, recorded network packets that can be inspected later. Analysts use it to reconstruct communication and investigate protocol behavior or suspicious traffic. upload, etc.) Not checked yet
6 details in Everything
Malcolm v1.8.0 adds 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. authentication (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. & OpenLDAP OpenLDAP An open-source implementation of the Lightweight Directory Access Protocol, maintained by the OpenLDAP Project, used to store and query structured identity data like users and groups over a network. ) and introduces Hedgehog Linux sensor OS build scripts.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.8.0 https://github.com/cisagov/Malcolm.git
$ git checkout v1.8.0
Adds authentication against an LDAP server, supporting Microsoft Active Directory Domain Services (Windows Server 2016) and OpenLDAP, each with StartTLS, 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. , and unencrypted connections. Not checked yet Adds build scripts for a network sensor OS installable and live ISO ISO A widely adopted international standards body that publishes technical specifications; cyber tools cite ISO standards to signal compliance with recognized benchmarks for quality, security, or interoperability. , Hedgehog Linux. Not checked yet
2 details in Everything
Malcolm v1.7.1a redesigns its PCAP PCAP A packet capture, recorded network packets that can be inspected later. Analysts use it to reconstruct communication and investigate protocol behavior or suspicious traffic. pipeline with a ØMQ pub/sub architecture and splits the monolithic Moloch container into three dedicated services.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.7.1a https://github.com/cisagov/Malcolm.git
$ git checkout v1.7.1a
└──▷ USE IT
Allow Malcolm to ingest PCAP files where packets were captured with a snaplen shorter than the full packet — common with older or misconfigured capture setups.
ini
copy
readTruncatedPackets=true
Enables readTruncatedPackets in Moloch's config.ini to handle a wider range of PCAP files that contain truncated packets. Not checked yet Redesigns the PCAP processing pipeline around a ØMQ pub/sub model: pcap_watcher.py watches /data/pcap/processed and publishes to a topic, while pcap_moloch_and_zeek_processor.py and future processors subscribe — increasing parallelism and making new PCAP processors easier to add. Not checked yet Moves common Logstash enrichments into a modular, separate pipeline under logstash/pipelines/, with logstash-start.sh dynamically detecting and configuring new pipelines at startup to simplify adding future parsers. Not checked yet Splits the monolithic Moloch container into three discrete containers: pcap-monitor, zeek, and moloch. Not checked yet Adds OpenContainers-compatible labels to all Docker containers. Not checked yet
5 details in Everything
└──▷ BREAKING ON UPGRADE
! The single Moloch container has been split into three separate containers (pcap-monitor, zeek, moloch); any deployment configuration, compose files, or orchestration referencing the monolithic Moloch container will need to be updated.
Malcolm v1.7.0 ships Zeek 3.0, ten new protocol analyzers/plugins, BZAR 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. analytics, and ZeroMQ ZeroMQ A messaging library that provides socket-like abstractions for async message passing over TCP, IPC, or in-process transports, letting tools wire together distributed components without a dedicated message broker. -based file scanning.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.7.0 https://github.com/cisagov/Malcolm.git
$ git checkout v1.7.0
Adds internal_source, external_source, internal_destination, external_destination tags via the Logstash cidr plugin, derived from srcIp and dstIp Zeek log fields. Not checked yet Upgrades to Zeek 3.0. Not checked yet Adds Amazon.com ICS ICS Industrial Control Systems — hardware and software that monitor and control physical processes like power grids, pipelines, and manufacturing lines, making them a target for cyber tools focused on operational technology environments. protocol analyzers for industrial control system traffic analysis. Not checked yet Adds Corelight's bro-xor-exe plugin for XOR-encoded executable detection. Not checked yet Adds Corelight's community ID community ID A vendor-neutral network flow hashing standard, maintained by Corelight, that produces a consistent identifier for a connection across different tools so analysts can correlate events from disparate data sources. flow hashing plugin for cross-tool flow correlation. Not checked yet
+10 more
show less
Adds J-Gras' Bro::AF_Packet plugin for high-performance packet capture packet capture A packet capture, recorded network packets that can be inspected later. Analysts use it to reconstruct communication and investigate protocol behavior or suspicious traffic. . Not checked yet Adds Lexi Brent's EternalSafety plugin for 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. /EternalBlue exploit detection. 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. Cyber Analytics Repository's BZAR (Bro/Zeek ATT&CK-Based Analytics) script for ATT&CK-mapped behavioral analytics. Not checked yet Adds Salesforce's gQUIC analyzer for QUIC QUIC A UDP-based transport protocol standardized by the IETF that bakes in TLS 1.3, multiplexed streams, and connection migration, giving cyber tools low-latency encrypted transport without head-of-line blocking. protocol visibility. Not checked yet Adds Salesforce's HASSH SSH fingerprinting plugin for SSH client/server fingerprinting. Not checked yet Adds Salesforce's 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. TLS fingerprinting plugin for TLS client fingerprinting. Not checked yet Adds SoftwareConsultingEmporium's Bro::LDAP analyzer for 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. traffic parsing. Not checked yet Adds dashboards for all newly supported protocols. Not checked yet Switches to a ZeroMQ-based approach for the file scanning queue. Not checked yet Adds human-readable names to types created with Moloch WISE. Not checked yet
15 details in Everything
Malcolm v1.6.0 adds Zeek QUIC QUIC A UDP-based transport protocol standardized by the IETF that bakes in TLS 1.3, multiplexed streams, and connection migration, giving cyber tools low-latency encrypted transport without head-of-line blocking. protocol support with dedicated Kibana dashboards.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.6.0 https://github.com/cisagov/Malcolm.git
$ git checkout v1.6.0
Improves Kibana filter pivot actions from Moloch to Kibana. Not checked yet
1 detail in Everything
Malcolm v1.5.2 adds email alerting via ElastAlert and a Moloch-to-Kibana context menu pivot.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.5.2 https://github.com/cisagov/Malcolm.git
$ git checkout v1.5.2
Adds mechanism and example for sending email alerts via ElastAlert. Not checked yet Adds context menu pivot from Moloch to Kibana for most field values. Not checked yet Kibana can now be accessed at https://ip/kibana/ in addition to https://ip:5601/. Not checked yet
3 details in Everything
Malcolm v1.5.1 adds Windows 10 Docker Desktop support and exposes Kibana at localhost:443/kibana
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.5.1 https://github.com/cisagov/Malcolm.git
$ git checkout v1.5.1
Allows Kibana to be accessed at localhost:443/kibana in addition to localhost:5601. Not checked yet Adds support for running Malcolm on Windows 10 using Docker Desktop for Windows. Not checked yet Maps Zeek's host.name field (from Beats) to Moloch's node field. Not checked yet Moves JSON source record viewing in Moloch to the context menu of the ID field. Not checked yet
4 details in Everything
Malcolm v1.5.0 adds multi-user management UI, Community ID Community ID A vendor-neutral network flow hashing standard, maintained by Corelight, that produces a consistent identifier for a connection across different tools so analysts can correlate events from disparate data sources. flow fingerprinting, and HASSH SSH fingerprinting.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.5.0 https://github.com/cisagov/Malcolm.git
$ git checkout v1.5.0
└──▷ HOW TO FIND IT
Manage multiple analyst accounts without touching config files — reach the new user management UI in a browser.
📍 In Malcolm, open a browser and navigate to https://<malcolm-host>:488 to create, edit, or remove user accounts.
Adds multi-user support with a web-based user management interface accessible over port 488. Not checked yet Adds Community ID fingerprinting for network flows. Not checked yet Adds HASSH fingerprinting for SSH sessions. Not checked yet
3 details in Everything
Malcolm v1.4.0 adds multi-user support and user account management.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.4.0 https://github.com/cisagov/Malcolm.git
$ git checkout v1.4.0
Malcolm v1.3.0 adds configurable Elasticsearch index snapshot (backup) support.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.3.0 https://github.com/cisagov/Malcolm.git
$ git checkout v1.3.0
Adds the ability to configure snapshots (backups) of the Elasticsearch indices. Not checked yet
1 detail in Everything
Malcolm v1.2.2 adds index curation to automatically close or delete Elasticsearch indexes by age and/or size.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.2.2 https://github.com/cisagov/Malcolm.git
$ git checkout v1.2.2
Malcolm v1.2.0: open-source network traffic analysis suite combining Moloch, Zeek, CyberChef, and the Elastic Stack in a deployable Docker framework.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.2.0 https://github.com/cisagov/Malcolm.git
$ git checkout v1.2.0
Introduces Malcolm, an open-source network traffic analysis platform integrating Moloch, Zeek, CyberChef, and the Elastic Stack via Docker for IT and ICS ICS Industrial Control Systems — hardware and software that monitor and control physical processes like power grids, pipelines, and manufacturing lines, making them a target for cyber tools focused on operational technology environments. network visibility. Not checked yet Provides an interconnected framework that makes Moloch, Zeek, CyberChef, and the Elastic Stack work together as a unified network security analysis suite. Not checked yet Supports industrial control system (ICS) network traffic analysis alongside standard IT network traffic, broadening coverage to OT environments. Not checked yet Packages all components in Docker for flexible, self-contained deployment of the full analysis stack. Not checked yet
4 details in Everything