Download

ForgeIEC components at a glance

ForgeIEC consists of several components. Which ones you need depends on your role:

Installing from the package repository

ForgeIEC is provided as a signed Debian repository at apt.forgeiec.io and as a signed RPM repository at rpm.forgeiec.io — signed packages from an automated CI. Setup is a one-time step per workstation or target PLC — pick your distribution:

# Signier-Schlüssel hinterlegen
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://apt.forgeiec.io/forgeiec.gpg \
  | sudo tee /etc/apt/keyrings/forgeiec.gpg >/dev/null

# Repository-Quelle eintragen
echo "deb [arch=amd64,arm64,armhf signed-by=/etc/apt/keyrings/forgeiec.gpg] \
https://apt.forgeiec.io/trixie trixie main" \
  | sudo tee /etc/apt/sources.list.d/forgeiec.list

sudo apt update

# Signier-Schlüssel importieren
sudo rpm --import https://rpm.forgeiec.io/forgeiec-rpm.asc

# Repository eintragen
sudo tee /etc/yum.repos.d/forgeiec.repo >/dev/null <<'EOF'
[forgeiec]
name=ForgeIEC
baseurl=https://rpm.forgeiec.io/el9/$basearch/
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://rpm.forgeiec.io/forgeiec-rpm.asc
EOF

sudo dnf makecache

Then install the components individually:

# Workstation
sudo apt install forgeiec-studio          # ForgeIEC Studio
sudo apt install forgeiec-fdd-data        # device descriptions (recommended)

# Target PLC
sudo apt install forgeiec-anvil-server    # PLC runtime (Anvil server + all tongs-*)
sudo apt install forgeiec-hearth-server   # operator interface (preview)

# Operator panel
sudo apt install forgeiec-screen-wayland  # kiosk under Wayland
sudo apt install forgeiec-screen-xorg     # kiosk under X11

On RPM systems the commands are sudo dnf install … with the same package names — which packages exist there is shown in the table below (the runtime not yet).

The bus bridges (tongs-modbustcp, tongs-ethercat, tongs-profibus, tongs-ethernetip) are not separate packages — they ship inside forgeiec-anvil-server and are started by the Anvil server.

The package forgeiec-bellows-server (OPC-UA gateway) remains in the APT repository but is resting — it is currently neither developed nor maintained.

Updates follow the normal apt update && apt upgrade cycle — no manual .deb files required.

Supported platforms

Debian / Ubuntu (apt.forgeiec.io)

Suite mapping: bullseye = Debian 11, bookworm = Debian 12, trixie = Debian 13, jammy = Ubuntu 22.04, noble = Ubuntu 24.04. armhf (ARMv7) is available for the runtime, Hearth and the device descriptions.

Enterprise Linux / Fedora (rpm.forgeiec.io)

Runtime as RPM: not available yet. forgeiec-anvil-server is currently shipped as a Debian package only.

There are two different signing keys: forgeiec.gpg (ed25519) for apt and forgeiec-rpm.asc (RSA-4096) for rpm. The difference is not cosmetic — RHEL 9 ships rpm 4.16, whose internal PGP parser cannot verify ed25519.

Windows

A Windows build of ForgeIEC Studio exists and its CI runs. There is no public download yet — you get the installer on request at blacksmith@forgeiec.io.

Source code

The source code is licensed under AGPL-3.0-or-later (the part linked into your project under Apache-2.0). The repositories are not publicly browsable — access on request: send your SSH public key to blacksmith@forgeiec.io and we will enable it. Afterwards these repositories, among others, are open to you:

• ForgeIEC Studio: ForgeIEC/forgeiec-studio
• Anvil server (anvild): ForgeIEC/anvil
• Tongs (bus bridges): ForgeIEC/tongs-core and one ForgeIEC/tongs-* per protocol
• Hearth: ForgeIEC/hearth
• bellowsd (resting): ForgeIEC/bellows
• Website: ForgeIEC/forgeiec-website

The normative specifications live in the forgeiec-studio repository under documentation/architecture/.

Building from source

# Clone the repository (with submodules) — SSH only, after
# your SSH public key has been enabled
git clone --recurse-submodules ssh://git@git.forgeiec.io/ForgeIEC/forgeiec-studio.git
cd forgeiec-studio

# Build the Studio
cmake -B build -DCMAKE_BUILD_TYPE=Release && cmake --build build -j$(nproc)

# Deploy to the local system
./deploy.sh all

Prerequisites (Debian 12/13, Ubuntu 24.04), as the CI installs them:

sudo apt install build-essential cmake ninja-build pkg-config git \
  qt6-base-dev qt6-base-dev-tools qt6-tools-dev qt6-tools-dev-tools \
  libqt6svg6-dev libqt6sql6-sqlite libqt6charts6-dev libqt6opengl6-dev \
  libgl-dev libssl-dev libre2-dev libargon2-dev libsqlite3-dev libxml2-dev \
  libtomlplusplus-dev libprotobuf-dev protobuf-compiler \
  libgrpc++-dev protobuf-compiler-grpc \
  forgeiec-libforge-mcp-dev   # from the ForgeIEC APT repository
# Debian 13 additionally: qt6-svg-plugins

The authoritative list is the package set in .forgejo/workflows/linux.yml in the repository.

Example projects

Examples shipped with ForgeIEC Studio (Studio: File → Open Example):

Next steps

• First steps with ForgeIEC Studio
• Setting up the AI assistant
• Bus configuration
• News + release notes