Windows Setup Guide
Step-by-step instructions for installing AgentOne on Windows, including solutions for common installation issues
The setup guide for Windows is almost finished. If you find something missing or need help, join our Discord server.
There are two primary ways to install AgentOne on Windows. We recommend installing from agent-one.dev.
Install from agent-one.dev (recommended)
Download the desktop app installer
Click the Download app button in the bottom left of your account dashboard or head to:
https://www.agent-one.dev/download
You'll be redirected to a download page, which will attempt to automatically detect your operating system. Make sure the Windows tab at the top of the page is selected:
Now click Download AgentOne for Windows.
Run the installer
You're almost done! After downloading the installer, open it (click or double-click the .exe file) and follow the prompts to install AgentOne on your system. If you get stuck, refer to the Windows Installer troubleshooting section below.
Install from GitHub
If you followed the steps in the Install from agent-one.dev section, you can skip this section.
Select the latest release
Usually, the latest release is the first release on the list. You'll see a green Latest badge next to the latest stable release. If the release has a Pre-release badge or title, don't use it unless you're a developer.
Once you've found the latest release, click on its title (for example, AgentOne 1.0.0) to navigate to that release.
Download the desktop app installer
Scroll to the bottom of the release page and expand the Assets accordion.
Look for a file named AgentOne_x.x.x_x64-setup.exe and click on it to download it.
.exe file, not the .exe.sig file.
Run the installer
You're almost done! After downloading the installer, open it (click or double-click the .exe file) and follow the prompts to install AgentOne on your system. If you get stuck, refer to the Windows Installer troubleshooting section below.
Troubleshooting
Download Blocked by Windows
If your system is equipped with Windows Defender SmartScreen or similar security features, you may encounter warnings when attempting to download or run the installer. This is not a problem with AgentOne or Windows, it's a feature built-in to your computer.
If you see a SmartScreen warning, look for an option like Advanced, Proceed anyway, or similar. In Microsoft Edge, click the three dots next to the download and select Keep. You may see an additional screen warning you that AgentOne isn't commonly downloaded. Next to the Delete button, click the dropdown arrow and select Keep anyway.
The file should then begin downloading. Once it finishes, you can click "Open file" to run the installer and follow the prompts to complete the AgentOne installation. If you encounter any issues while running the installer, see the Windows Installer troubleshooting section.
Windows Installer
If you get stuck or are unsure what option to select while running the AgentOne installer, reference this section. It will walk you through running the Windows installer exe that you downloaded in either of the previous sections.
Run the installer
After downloading the installer, try opening it from your browser. It's probably listed in the top-right corner of your browser window under a Downloads icon.
If you can't find the file, try this:
- Open your File Explorer and navigate to the
Downloadsfolder. - Look for the
AgentOne_x.x.x_x64-setup.exefile and double-click it to start the installation. - If you saved the file to a different location, navigate to that folder and double-click the installer file.
Choose an install location
The installer window should prompt you for an installation. If you see a screen like this one first, simply click Next:
The installer should automatically detect the correct location to install AgentOne. Click Next to continue. If it doesn't choose a location for you, a good default location is C:\Users\<username>\AppData\Local\AgentOne (replacing <username> with your username).
Finish the installation
The installer should continue installing AgentOne. After each step completes, simply click Next. When the installer is finished, you'll see a Finish button and two options:
- Create desktop shortcut
- Launch AgentOne
We recommend leaving both boxes checked and clicking Finish.
Other Problems
Having a different issue? Join our Discord server for live support!