apt

linuxcnc-ethercat apt repository

Debian apt repository for the linuxcnc-ethercat and ethercat projects, served via GitHub Pages.

URL: https://linuxcnc-ethercat.github.io/apt/

Supported distributions

Codename	Debian	Architectures
bullseye	11	amd64, arm64
bookworm	12	amd64, arm64
trixie	13	amd64, arm64

Usage

# 1. Fetch the archive signing key
sudo curl -fsSL https://linuxcnc-ethercat.github.io/apt/linuxcnc-ethercat-apt.gpg \
    -o /usr/share/keyrings/linuxcnc-ethercat-apt.gpg

# 2. Detect the codename and add the apt source
. /etc/os-release
case "$VERSION_CODENAME" in
    bullseye|bookworm|trixie) ;;
    *) echo "Unsupported codename: $VERSION_CODENAME (supported: bullseye, bookworm, trixie)" >&2; exit 1 ;;
esac
echo "deb [signed-by=/usr/share/keyrings/linuxcnc-ethercat-apt.gpg] \
https://linuxcnc-ethercat.github.io/apt/ $VERSION_CODENAME main" \
    | sudo tee /etc/apt/sources.list.d/linuxcnc-ethercat.list

# 3. Update and install
sudo apt-get update
sudo apt-get install linuxcnc-ethercat ethercat-master

HAL getter/setter flavor (`getset` component)

linuxcnc-ethercat ships in two HAL API flavors. The plain build in the main component supports LinuxCNC 2.9.x and 2.10 builds predating the HAL getter/setter API change (July 2026). If you run LinuxCNC 2.10 built from current master (new getter/setter HAL API), enable the getset component instead - its +getset packages sort higher and their linuxcnc-uspace (>= 1:2.10.0~pre1) dependency matches only new-API systems, so apt upgrades you to the right flavor in place:

# same as step 2 above, but list both components
echo "deb [signed-by=/usr/share/keyrings/linuxcnc-ethercat-apt.gpg] \
https://linuxcnc-ethercat.github.io/apt/ $VERSION_CODENAME main getset" \
    | sudo tee /etc/apt/sources.list.d/linuxcnc-ethercat.list
sudo apt-get update
sudo apt-get install linuxcnc-ethercat

Only enable getset on systems running new-API LinuxCNC: on 2.9-era systems the +getset candidate’s dependency is unsatisfiable and apt will refuse to install or upgrade the package. bullseye carries no getset packages (new-API LinuxCNC needs a newer compiler than bullseye provides).

[!WARNING] If you recently ran apt upgrade and a new kernel was installed but you have not rebooted yet, reboot first. The ethercat DKMS module is built only for the running kernel, so installing mid-update leaves you without a working module after your next reboot. If this already happened, run sudo dkms autoinstall and sudo systemctl restart ethercat.

Signing key

Fingerprint: 480E E771 AEFB A7BE 1FBE D258 BC33 B93B F271 4DA7
Identity: LinuxCNC-EtherCAT APT Archive Key <apt@linuxcnc-ethercat.github.io>

Maintenance

Releases are ingested automatically: each source repo’s release workflow fires a repository_dispatch of type ingest-release against this repo, which runs .github/workflows/ingest.yml to pull the tag’s .deb assets and add them to the pool via reprepro.

Manual ingestion is also available via Actions -> Ingest release -> Run workflow.

apt