Getting Started

Getting Started

Prerequisites

Requirement	Notes
Linux x86-64	Tested: Manjaro, Arch, Debian/Ubuntu, Fedora
Node.js 18+	node --version to check
npm	Bundled with Node.js
msitools	Arch: sudo pacman -S msitools · Debian: sudo apt install msitools · Fedora: sudo dnf install msitools
Docker	Optional — for LMS container (same-machine AMT access)

Install via AUR (Arch / Manjaro)

yay -S intel-amt-linux

First launch downloads Intel® Manageability Commander 2.4.0 from Intel's servers (~45 MB, SHA256 verified). Stored under /opt/intel-amt-linux/upstream/. Subsequent launches are instant.

Install from source

git clone https://github.com/88plug/intel-amt-linux
cd intel-amt-linux
npm run setup

npm run setup will:

1. Download Intel® Manageability Commander 2.4.0 MSI from Intel (or Wayback Machine fallback)
2. Verify SHA256 checksum
3. Extract with msiextract
4. Install Electron 28 and app dependencies
5. Replace Windows-only native modules with Linux implementations
6. Patch main-electron.js for Electron 28 + credential vault

Launch

npm start

Or use the AUR launcher:

intel-amt-linux

Docker (X11 forwarded)

xhost +local:docker
bash scripts/run.sh docker

Headless (Xvfb + VNC on port 5900)

bash scripts/run.sh docker-xvfb
# connect: vncviewer localhost:5900

Connecting to an AMT host

1. Launch → click + to add a system
2. Hostname/IP: use the AMT IP (may differ from OS IP — AMT has its own NIC stack)
3. Auth: Digest
4. Username: admin
5. Password: your AMT MEBx provisioning password
6. TLS: Yes (port 16993) — required for AMT 16.1+ (Alder Lake / Raptor Lake)

To find AMT IPs on your subnet:

nmap -p 16992,16993 192.168.1.0/24 --open -oG - | grep open

Credential Vault

When the auth dialog appears, check "Remember credentials". Credentials are encrypted with your OS keyring (libsecret / KWallet) via Electron safeStorage and auto-fill on next connection.

Requires libsecret (GNOME) or kwallet (KDE) installed. On headless systems, set ELECTRON_PASSWORD_STORE=basic for an unencrypted fallback.