Install or Upgrade Server

Last modified: June 21, 2023

Before installing and activating Server, verify your network has access to all required licensing system domains. Go to Licensing System Requirements for a complete list.


To install and run Server, your system has to have these prerequisites.

  • Review the System Requirements for Server. 
  • Ensure the computer can contact the web domain used by the Alteryx licensing system.
  • Admin access to the host server's operating system or physical access to the server hardware.
  • Read access to Active Directory, if you plan to use Integrated Windows Authentication. Visit the Server Authentication help page to learn more about authentication options.
  • Read and write permissions to the file share.
  • Alteryx admin user.

Download Server Installation File

Download the Server product from the Alteryx Licensing & Downloads portal.

  1. Sign in to the Alteryx Licensing & Downloads portal.
  2. Under Product Downloads, select Alteryx Server.
  3. On the Download Products page, select the version of Server you want to download.

  4. On the Preference page, select Download.

Install Server

  1. Run the Alteryx Server Installer with admin rights. (Right-click and select Run as administrator.)
  2. Confirm the destination folder and select Next.
  3. Check the I accept the license agreement checkbox and select Next.
  4. Select 1 of these options and select Finish.
    • Configure Server now: Opens the System Settings window to configure Server.
    • Close and run Alteryx Designer later: Closes the installation window. Access the system settings at any time via the Alteryx System Settings desktop icon.
    • Install Predictive Tools: Installs the predictive tools in Designer. The predictive tools use R, an open-source programming language used for statistical and predictive analysis. Select this option to launch the R installer. You have to install the predictive tools to use the predictive macros in Designer. To install at a later time, go to Options > Download Predictive Tools in Designer.

We recommend you install all Server components on a separate, physical drive (for example, D:) from the OS install. To avoid latency, use a local, solid-state drive not a network drive. Assign all workspaces and directories to use the same drive as the installation.

Benefit: This minimizes input/output contention with OS operations.

License Your Server

If you haven't licensed your Server, you are prompted to do so. Use the license key from your license administrator to activate a product license. If the license prompt doesn't immediately load, you can access it in Designer under Options > Manage Licenses > Activate New License.

Activate Online
  1. In the Alteryx Server Activation window, enter your email address.
  2. Enter your License keys one per line.
  3. Select Activate.
  4. In the Activation Success window, select Start Solving.
Activate Offline

As an alternative to online activation, you can submit a request for an activation (BIN) file. If you want to activate with a file, select Activate with File to open the Alteryx Offline Activation window.

Step 1. Create a Request (REQ) File from the Offline Computer

  1. Open Designer. If the Alteryx Designer Activation window doesn't open, select Options > Manage Licenses > Activate New License.
  2. Select Activate Offline License.
  3. In the Alteryx Offline Activation window, select Create in the Request step to create a request (REQ) file.
  4. Enter your First nameLast nameEmail address, and your License keys.
  5. Select Create request. Alteryx creates a request file with your email address and REQ extension as shown in this example:
  6. Select Save to save the request (REQ) file where it can be accessed from the Alteryx Licensing & Downloads portal or send the file to your license administrator.

Step 2. Upload the Request File to the Alteryx Downloads and Licenses Portal

This step requires internet access.

  1. Sign in to the Alteryx Licensing & Downloads portal.
  2. On the Home page, select Activate Offline License.
  3. When you have your request file ready, select Next.
  4. Upload or drop your request (REQ) file to the window.
  5. The Alteryx Licensing & Downloads portal generates an activation file with your email address and BIN extension as shown in this example:
  6. Save the activation (BIN) file so that you can access it from the offline computer.

Step 3. Open the Activation (BIN) File on the Offline Computer

  1. In the Alteryx Designer Activation window on the offline computer, select Back.

    Or, select Options > Manage Licenses > Activate New License to open the Alteryx Offline Activation window.

  2. Select Browse and select the activation (BIN) file.
  3. In the Activation Success window, select Start Solving.
Activate Using a License Server

The Alteryx License Server allows for the hosting and managing of purchased product licenses within an organizations' internal network. License Server allows for smoother and more-secure deployment of Alteryx products, especially behind proxies and firewalls. Download License Server from the Alteryx Licensing & Downloads portal.

  1. Open Designer. If the Alteryx Designer Activation window doesn't open, select Options > Manage Licenses > Activate New License.

    If you don't have valid licenses, License Server displays Install License. Select OK to continue.

  2. Select the here link within To access your License Server, click here text. License Server displays Manage Products.
  3. In License Server Connectivity, select Connect. License Server displays available licenses. If this is the first time you have activated a license, enter your email address.​​​​​​
  4. Select Activate for each product you want to activate.
  5. Select Close.

For more help including command line options, go to Product Activation and Licensing Help.

Upgrade Server

Migration Prep Tool

To use the latest and best cryptography throughout Server to protect data at rest and data in flight, you now have a way to get your crypto migrated to the most modern algorithms without taking a lot of downtime and interrupting your business.

To move to more modern crypto (FIPS capable), we at Alteryx prepared a Migration Prep Tool to mitigate the maintenance window downtime that you require to get all your workflows migrated to the new crypto standard.

For more information about this tool, visit the Migration Prep Tool help page. 

When you upgrade to Server version 22.1, we recommend validating your engine choice settings and resource allocations. The new 'Allow Server to manage workflows running simultaneously' functionality, and the change to enable AMP by default, can result in settings changing in your environment.

If you have an existing Server and want to maintain your current system settings, please read these instructions before upgrading.

1.    Controller > General > Enable AMP Engine 

      1.  Before upgrading, note your current settings.

      2. After upgrading, restore the selection to your desired value. 

2.    Worker > General > Allow Server to manage workflows running simultaneously 

      1. Before upgrading, note the number set for ‘workflows allowed to run simultaneously’.

       2. After upgrading, deselect ‘Allow Server to manage workflows running simultaneously’.

       3. Input the number you saved for ‘workflows allowed to run simultaneously’.

3.    Engine > General > Engine 

     1. Before upgrading, note your current settings.

     2. After upgrading, restore the selection to your desired value. 

4.    Engine > General > Run engine at a lower priority

      1. Before upgrading, note your current settings.

      2. After upgrading, restore the selection to your desired value. 

Follow these steps to upgrade to a newer Server version:

  1. Stop the AlteryxService.
    1. Open Task Manager.
    2. Select the Services tab. 
    3. Locate the AlteryxService
    4. Right-click and select Stop.
  2. Perform a backup of the MongoDB. Go to MongoDB Backups.
  3. Follow the download and install steps to upgrade to a newer version of Server.
  4. If you are upgrading to a Server version that uses another MongoDB version, select Migrate Mongo Database to run the migration utility during the install process to update the MongoDB version. Go to the MongoDB Schema Reference for a table showing what MongoDB versions correspond with Server versions.
    Screenshot of Install screen highlighting the Migration Mongo Database option

The Alteryx Service should automatically start after the upgrade. The Alteryx Service has to be running to access the Server. If you can't access Server, confirm the Alteryx Service has restarted. 

Migration Performed by the Service When First Starting after Upgrade

When the Service first starts after upgrade, it migrates any workflows not already migrated by the Migration Prep Tool as well as additional MongoDB collections and the RuntimeSettings.xml file. This progress is logged to AlteryxServiceMigrator_#.log in the folder specified by Alteryx System Settings > Controller > Logging.

The RuntimeSettings.xml file is backed up to RuntimeSettings.22_2_legacy.xml during this process. If you choose to rollback your upgrade, you should replace RuntimeSettings.xml with RuntimeSettings.22_2_legacy.xml to restore the file to its pre-upgrade state.

Note that the cryptography migration only happens when upgrading to or through version 2022.3.

  1. Open Task Manager.
  2. Select the Services tab. 
  3. Locate the AlteryxService.
  4. Confirm the Status shows Running.
  5. If the Status shows Stopped, right-click and select Start.

What's Next?

Configure Server from the System Settings.

Was This Page Helpful?

Running into problems or issues with your Alteryx product? Visit the Alteryx Community or contact support. Can't submit this form? Email us.