Automic VaultAutomic Vault

brew

Install hercules with Homebrew, apt, dnf, MacPorts, Nix

System/370, ESA/390 and z/Architecture Emulator. Version 4.9.1 via Homebrew; verified from local package data.

install

Additional install commands

macOS

Homebrewverified · 100%
brew install hercules

local Homebrew formula metadata

MacPortsverified · 94%
sudo port install hercules

MacPorts ports tree · emulators/hercules/Portfile · source: api.github.com

Linux

Debian aptverified · 92%
sudo apt install hercules

Debian stable package indexes · hercules · source: deb.debian.org

Fedora dnfverified · 92%
sudo dnf install hercules

Fedora Rawhide package metadata · hercules · source: dl.fedoraproject.org

Nixverified · 92%
nix profile install nixpkgs#hercules

nixpkgs package indexes · pkgs/by-name/he/hercules/package.nix · source: api.github.com

overview

Package summary

System/370, ESA/390 and z/Architecture Emulator

Commands and aliases

  • card2txt
  • cckd2ckd
  • cckd642ckd
  • cckdcdsk
  • cckdcdsk64
  • cckdcomp
  • cckdcomp64
  • cckddiag
  • cckddiag64
  • cckdmap
  • cckdswap
  • cckdswap64
  • cfba2fba
  • cfba642fba
  • ckd2cckd
  • ckd2cckd64
  • convto64
  • dasdcat
  • dasdconv
  • dasdconv64
  • dasdcopy
  • dasdcopy64
  • dasdinit
  • dasdinit64
  • dasdisup
  • dasdlist
  • dasdload
  • dasdload64
  • dasdls
  • dasdpdsu
  • dasdseq
  • dasdser

history

Project history and usage

Hercules is an open source emulator for IBM mainframe architectures: System/370, ESA/390, and z/Architecture. The Homebrew `hercules` package delivers the SDL Hercules 4.x Hyperion line and its collection of emulator, DASD, tape, card, and utility commands.

Project history

Roger Bowler's history says the idea dated back to 1994, with most of the initial implementation done in 1999. By autumn 1999 Hercules could IPL and run OS/360 MFT and Jan Jaeger's ZZSA standalone program; by early 2000 it could run more ESA/390-era operating systems.

In spring 2000, contributors expanded the project: Jay Maynard added S/370 virtual storage, Jan Jaeger added HMC and dynamic reconfiguration work, Windows ports and front ends broadened access, Debian packaging appeared, and compressed/shared DASD work improved practical use.

The SDL Hercules 4.x Hyperion README describes Hercules as created by Roger Bowler, maintained by Jay Maynard from 2000 to 2012, and advanced by Jan Jaeger through features such as dynamic reconfiguration, integrated console, interpretive execution, and z/Architecture support. The SDL Hyperion line contains fixes and enhancements beyond earlier 3.x and 4.0 versions.

Adoption history

Hercules became important to hobbyists, educators, systems programmers, and preservation-minded users because it made mainframe operating-system practice possible on ordinary host machines. Bowler's history also notes IBM engineers and mainframe specialists using Hercules for testing and demonstrations.

Its adoption is inseparable from legal and operational constraints around mainframe software: Hercules emulates hardware, but users still need operating systems and licenses or public-domain systems they may legally run. That boundary shaped its culture as both a learning tool and a serious emulator.

How it is used

A Hercules installation is driven by `hercules.cnf`, which describes CPUs, memory, channels, consoles, DASD, tapes, networking, and peripheral devices. The package includes many utilities for creating, converting, inspecting, and manipulating mainframe disk and tape images.

Users run the emulator to IPL operating systems, operate consoles, attach DASD/tape/card devices, and experiment with S/370, ESA/390, or z/Architecture environments. SDL Hyperion documentation covers installation, operation, networking, automatic operator behavior, tracing, and architecture-specific features.

Why package nerds care

Hercules is a package-manager oddity in the best sense: installing one formula gives a workstation a miniature mainframe lab plus a toolbox for legacy storage media formats. It is not just one command but a cluster of emulator support programs.

For preservation and systems-history users, package-manager availability lowers the barrier to repeatable mainframe experiments. For maintainers, the value is in making a complex C emulator and its utilities reproducible across Unix-like hosts.

Timeline

  • 1994: Roger Bowler dates the germ of Hercules to this period.
  • 1999: Most initial work was done, enough to IPL and run early operating-system workloads.
  • 2000: Jay Maynard took over project control; major contributors added S/370 storage, VM/ESA-related support, Windows access, packaging, and DASD work.
  • 2001: Hercules implemented z/Architecture support soon after IBM published the architecture manual.
  • 2005: Hercules contributors shared the NaSPA Award for Technical Excellence.
  • 2016: The SDL-Hercules-390 Hyperion GitHub repository was created for the 4.x Hyperion line.

Related projects

  • SDL Hercules 4.x Hyperion is the maintained line represented by the Homebrew package metadata.
  • Earlier Hercules 3.x and 4.0 lines are the historical base described by the Hyperion README.
  • IBM System/370, ESA/390, and z/Architecture operating systems and media images are the workloads Hercules exists to emulate, subject to licensing.

security posture

Risk level: green

narrow executable package without higher-risk signals.

Risk classifier

green risk · low confidence · appliance

Why

  • narrow executable package without higher-risk signals

Signals

  • metadata:no-higher-risk-signals

Install behavior

  • No Homebrew post-install hook is recorded in formula metadata.
  • Homebrew bottle metadata is available for 6 platform targets.
  • Build metadata lists 5 build dependencies.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

local files

Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.

Configuration files

Config paths the tool may read or write during local use.

Unix
hercules.cnf

executables

Installed executables

CommandKindExposureNote
card2txtcliglobal executable
cckd2ckdcliglobal executable
cckd642ckdcliglobal executable
cckdcdskcliglobal executable
cckdcdsk64cliglobal executable
cckdcompcliglobal executable
cckdcomp64cliglobal executable
cckddiagcliglobal executable
cckddiag64cliglobal executable
cckdmapcliglobal executable
cckdswapcliglobal executable
cckdswap64cliglobal executable
cfba2fbacliglobal executable
cfba642fbacliglobal executable
ckd2cckdcliglobal executable
ckd2cckd64cliglobal executable
convto64cliglobal executable
dasdcatcliglobal executable
dasdconvcliglobal executable
dasdconv64cliglobal executable
dasdcopycliglobal executable
dasdcopy64cliglobal executable
dasdinitcliglobal executable
dasdinit64cliglobal executable
dasdisupcliglobal executable
dasdlistcliglobal executable
dasdloadcliglobal executable
dasdload64cliglobal executable
dasdlscliglobal executable
dasdpdsucliglobal executable
dasdseqcliglobal executable
dasdsercliglobal executable
dmap2hrccliglobal executable
fba2cfbacliglobal executable
fba2cfba64cliglobal executable
hercifccliglobal executable
herclincliglobal executable
herculescliglobal executable
hetgetcliglobal executable
hetinitcliglobal executable
hetmapcliglobal executable
hetupdcliglobal executable
maketapecliglobal executable
tapecopycliglobal executable
tapemapcliglobal executable
tapespltcliglobal executable
tfprintcliglobal executable
tfswapcliglobal executable
txt2cardcliglobal executable
vmfplc2cliglobal executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-07-08
manager version4.9.1
manager updated
local dataok
upstreamnot checked
latest detectednot detected

https://github.com/SDL-Hercules-390/hyperion

install metadata

Package metadata

Package keybrew:hercules
Version4.9.1
Package managerHomebrew
Package manager pagehttps://formulae.brew.sh/formula/hercules
Homepagehttps://sdl-hercules-390.github.io/html/
Repositoryhttps://github.com/SDL-Hercules-390/hyperion
Upstream docshttps://sdl-hercules-390.github.io/html
LicenseQPL-1.0
Source archivehttps://github.com/SDL-Hercules-390/hyperion/archive/refs/tags/Release_4.9.1.tar.gz
Build dependenciesautoconf, automake, cmake, gnu-sed, libtool
Bottleavailable (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-installnot defined
Servicenone declared

registry facts

Source database details

Source DatabaseHomebrew formula API
Taphomebrew/core
Full Namehercules
Version Scheme0
Revision0
Head VersionHEAD
Bottle Stable Root URLhttps://ghcr.io/v2/homebrew/core
Deprecatedno
Disabledno
Keg Onlyno
URL Keys
  • head
  • stable

source database matches

Other package-manager records

Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.

Debian apt95%

hercules 3.13-8

System/370, ESA/390 and z/Architecture Emulator

http://www.hercules-390.eu/

sudo apt install hercules
  • Section: otherosfs
  • Architecture: amd64
  • 5 dependencies
  • 1 optional deps
  • normalized package name match
  • Matched by: Hercules
Debian stable package indexes · deb.debian.org · Debian stable package indexes: hercules from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz
Nix95%

hercules

nix profile install nixpkgs#hercules
  • normalized package name match
  • Matched by: Hercules
nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/he/hercules/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
Ubuntu apt95%

hercules 3.13-7

System/370, ESA/390 and z/Architecture Emulator

http://www.hercules-390.eu/

sudo apt install hercules
  • Section: universe/otherosfs
  • Architecture: amd64
  • 5 dependencies
  • 1 optional deps
  • normalized package name match
  • Matched by: Hercules
Ubuntu 24.04 LTS package indexes · archive.ubuntu.com · Ubuntu 24.04 LTS package indexes: hercules from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz
dnf95%

hercules 3.13-22.fc44

Hercules S/370, ESA/390, and z/Architecture emulator

http://www.hercules-390.eu/

sudo dnf install hercules
  • License: QPL-1.0
  • Category: Unspecified
  • Architecture: x86_64
  • Source Package: hercules
  • 9 dependencies
  • 9 provides
  • normalized package name match
  • Matched by: Hercules
Fedora Rawhide package metadata · dl.fedoraproject.org · Fedora Rawhide package metadata: hercules from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst
MacPorts95%

hercules

sudo port install hercules
  • normalized package name match
  • Matched by: Hercules
MacPorts ports tree · api.github.com · MacPorts ports tree: emulators/hercules/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Used sources

  • Geiger risk classifier
  • Nucleus package database
  • av.db category and tag curation
  • cross-ecosystem install command graph
  • curated configuration and credential file locations
  • curated package history
  • external package-manager database matches
  • package relationship graph
  • package version freshness
  • package-page enrichment