Skip to main content

​
System Requirements

​
Windows

  • Windows 10 or later
  • Microsoft Edge WebView2 Runtime
  • 4GB RAM minimum (8GB recommended for large datasets)
  • 200MB disk space

​
Linux

  • Ubuntu 20.04+, Debian 11+, Fedora 35+, Arch Linux, or openSUSE
  • WebKitGTK 4.0 or 4.1
  • 4GB RAM minimum (8GB recommended for large datasets)
  • 200MB disk space
The sidecar binary (reqflow-sidecar) is required for AzureTLS HTTP requests but optional. RustTLS requests will still work without it.

​
Download

1

Get the Latest Release

Download the latest version from the GitHub Releases page.Current version: v0.2.3Choose the appropriate package for your operating system:
  • Windows: ironbullet-v0.2.3-windows-x64.zip
  • Linux: ironbullet-v0.2.3-linux-x64.tar.gz
2

Extract the Archive

Extract the downloaded archive to a folder of your choice.The archive contains:
  • ironbullet / ironbullet.exe - Main application binary
  • reqflow-sidecar / reqflow-sidecar.exe - Sidecar for AzureTLS HTTP (must be in same directory)
  • start.sh (Linux only) - Launcher script with dependency checks

​
Windows Installation

​
Install WebView2 Runtime

IronBullet requires the Microsoft Edge WebView2 Runtime. Most Windows 10/11 systems already have it installed.
1

Check if WebView2 is Installed

Try launching ironbullet.exe. If WebView2 is missing, you’ll see an error dialog.
2

Download WebView2 Runtime

If needed, download the WebView2 Runtime from:https://go.microsoft.com/fwlink/p/?LinkId=2124703This is the official Microsoft evergreen bootstrapper installer.
3

Install and Restart

Run the installer and follow the prompts. After installation completes, launch ironbullet.exe.
Ensure reqflow-sidecar.exe is in the same directory as ironbullet.exe. The application will run without it, but AzureTLS HTTP requests won’t work.

​
Launch IronBullet

Simply double-click ironbullet.exe to start the application.

​
Linux Installation

​
Install WebKitGTK

IronBullet requires WebKitGTK for its embedded web renderer. Install it using your distribution’s package manager: 
sudo apt update
sudo apt install libwebkit2gtk-4.1-0

​
Launch IronBullet

1

Use the Launcher Script (Recommended)

The start.sh script checks for dependencies and displays helpful error messages:
cd /path/to/ironbullet
./start.sh
The script will:
  • Check for WebKitGTK installation
  • Verify the reqflow-sidecar binary
  • Make binaries executable
  • Launch IronBullet with proper error handling
2

Alternative: Direct Launch

You can also run the binary directly:
cd /path/to/ironbullet
chmod +x ironbullet reqflow-sidecar
./ironbullet
If WebKitGTK is not installed, the binary will crash with a dynamic linker error. Use start.sh for better error messages.
Ensure reqflow-sidecar is in the same directory as the ironbullet binary and is executable (chmod +x reqflow-sidecar).

​
CLI Mode

IronBullet also supports CLI mode for headless execution: 
ironbullet --config pipeline.json --help
When running with --config or --help flags, IronBullet runs in CLI mode without launching the GUI.
On Windows, the binary will automatically attach to the parent console when running in CLI mode, so output is visible in your terminal.

​
Verification

After installation, verify IronBullet is working:
1

Launch the Application

Start IronBullet using the appropriate method for your OS.
2

Check the Main Window

You should see the IronBullet interface with:
  • Block palette on the left
  • Canvas in the center
  • Settings panel on the right
3

Test Block Placement

Try dragging an HTTP Request block from the palette onto the canvas to verify the interface is responsive.

​
Troubleshooting

​
Windows: WebView2 Not Found

If you see “WebView2 runtime was not found” error:
  1. Download and install from https://go.microsoft.com/fwlink/p/?LinkId=2124703
  2. Restart IronBullet after installation
  3. If still not working, try installing Edge browser (includes WebView2)

​
Linux: Dynamic Linker Error

If you see errors like “error while loading shared libraries: libwebkit2gtk”:
  1. Install WebKitGTK using the commands above for your distribution
  2. Verify installation: ldconfig -p | grep libwebkit2gtk
  3. Use the start.sh launcher script for better error messages

​
Missing Sidecar Binary

If you see warnings about reqflow-sidecar not found:
  1. Ensure you extracted the complete archive
  2. Keep reqflow-sidecar in the same directory as the main binary
  3. On Linux, make it executable: chmod +x reqflow-sidecar
  4. RustTLS HTTP requests will still work without it

​
Next Steps

Now that IronBullet is installed, continue to the Quick Start guide to create your first pipeline.