New to Ferqon? This guide walks you through everything from install to your first hardware test—no prior experience with board testing required.
Last updated: August 15, 2026
Ferqon is a self-hosted test system for embedded boards. You install the CLI and server on one machine, then connect target boards over USB, JTAG, or SWD to run automated hardware-in-the-loop (HIL) tests.
Ferqon is especially useful for teams that want a shared board shelf, scheduled test runs, and CI/CD integration without sending hardware data to a cloud service.
Run the one-line installer for your platform.
Add the Ferqon apt repository
# Add the Ferqon apt repository (one-time setup)
curl -fsSL https://ferqon-apt.revyrlabs.workers.dev/install.sh | sudo bash
# Install the CLI and server
sudo apt install ferqon-cli ferqon-server
# Verify the CLI works
ferqon --version
ferqon --helpNote
ferqon is not found, run hash -r or open a new terminal.Install the Windows binaries
# Install from the release directory
.\install_windows.ps1
# Verify the CLI works
ferqon --version
ferqon --help
# Start the server
ferqon server start --detachNote
ferqon command is available on PATH.The setup wizard creates the data directory and default configuration.
Run the setup wizard
ferqon setupThe wizard writes ~/.config/ferqon/config.yml and creates ~/.ferqon_server/data.
If you have a paid or free license file, activate it now.
Activate your license
ferqon auth activate /path/to/license.jsonThen confirm the license is active:
Check license status
ferqon auth statusStart the local server. By default it runs on http://localhost:8000.
Start the server
ferqon server startCheck that the server is healthy:
Check server status
ferqon server statusPlug in a board, then discover it.
Scan for boards
ferqon devices scanList the available profiles for the board:
List board profiles
ferqon devices listStart the flash job (use COM3, COM4, etc. on Windows):
Flash the firmware
ferqon flash build/firmware.bin --device /dev/ttyACM0 --family rp2040 --board picoFlash on Windows
ferqon flash --device COM3 --family rp2040 --board Pico build/firmware.binWatch the status and logs:
Check flash status
ferqon flash statusView flash logs
ferqon flash logs