Installation

Download

You can download the Coord Runner from within the app:

1. Open the Runners page from the workspace sidebar.
2. Click Download Runner in the top-right corner.
3. Select the installer for your platform — macOS (Apple Silicon), macOS (Intel), Windows, or Linux.

You will also have the option to download the runner during onboarding after you first create your workspace.

macOS

1. Open the downloaded .dmg file.
2. Drag the Coord Runner icon to your Applications folder.
3. Open the app from Applications.

If macOS displays a security warning:

1. Open System Settings > Privacy & Security.
2. Scroll down to find the message about the Coord Runner being blocked.
3. Click Open Anyway.
4. Confirm when prompted.

This happens because the Coord Runner is distributed directly rather than through the Mac App Store. You only need to do this once.

Windows

1. Run the downloaded .exe installer.
2. Follow the installation prompts.
3. The Coord Runner is installed and ready to launch.

If Windows Defender SmartScreen shows a warning:

1. Click More info.
2. Click Run anyway.

This warning appears for new applications that have not yet built up a reputation with Microsoft's SmartScreen service.

Linux

AppImage

1. Download the .AppImage file.
2. Make it executable:

   chmod +x Coord-Runner-linux.AppImage

3. Run it:

   ./Coord-Runner-linux.AppImage

Auto-updates

The Coord Runner checks for updates automatically every 6 hours. When a new version is available, you see a notification in the app. You can also check manually by clicking Check for Updates in the runner settings. The auto-check can be toggled off in settings if you prefer to check manually.

Next steps

• Setup and sign-in — connect the runner to your account
• Configuration — configure workspace directory and agents