Calling all Racers for the Alteryx Grand Prix! It's time to rev your engines and race to the stage at Inspire! Sign up here.

Alteryx Server Knowledge Base

Definitive answers from Server experts.

How To: Downgrade Alteryx Server


How to downgrade Alteryx Server

Alteryx Server Upgrades can sometimes lead to unforeseen complications, creating an urgency to either resolve and or downgrade to avoid further disruption. While most issues can be resolved using resources on our community or by contacting Alteryx support, there are times when restoring to the last working version is a necessary step to address any underlying issues. This article provides on guidance on how to downgrade Alteryx Server.



  • Alteryx Server
    • Versions (All)
  • Last working Mongo Backup prior to upgrading ( Alteryx Server Backup and Recovery Procedures )
  • A backup of the Runtimesettings prior to upgrading. Click here for the location. The restore will most likely complete without this file and only required for major functional changes between versions.
    • Upgrade to/through 2022.3 will create the backup:  C:\ProgramData\Alteryx\RuntimeSettings.22_2_legacy.xml
  • MongoDB
    • Versions 3.4 and 4.0 (Embedded)
  • Download the previous version of Alteryx from
  • This article assumes you already have administrator permissions. 
  • Arrange downtime/maintenance window to perform downgrade 
Please Note: Prior to downgrading its worth searching Alteryx community and contacting Alteryx Support to discuss the reasons for wanting to downgrade. 

Important: Please ensure you have a backup of MongoDB prior to the upgrade. Without this you will NOT be able to downgrade.



Downgrade Alteryx Server

This procedure shows how to downgrade from Alteryx Server. For the purposes of this article we are downgrading from Alteryx Server 2021.2 to 2020.4 as an example.
  1. Connect to the Alteryx Server (For multi-node environments the Controller Node hosting MongoDB (Embedded))
  2. Open the Services.msc console and stop the service (How to start the Alteryx service -  select "stop" instead of start)
Note: If the service is stuck in a stopping state, its likely you have job running or queued. Please review this article for more info.
  1. Open the Control Panel by Search Control Panel  in the Start Menu
  2. Click on Programs and Features and uninstall both Alteryx 2021.2 and Predictive Tools. (Note predictive tools may uninstall with server)
  1. Click Remove and continue through any prompts to uninstall the program. Check the Control Panel again to confirm both Alteryx Server Package and Predictive tools have been uninstalled.
  1. Once completely uninstalled, Run the Alteryx Server Installer for 2020.4.6 (or whichever version your downgrading to). Remember to Right-click and select Run as administrator
  2. Select the folder path to install to if different from the default location. and select Next.
  1. Check the Licence Agreement and Click Next
  2. Once the installation is complete, You will be prompted to install Predictive tools (see below). If you intend on staying on this version and have workflows that rely on predictive tools, Select Install the Predictive Tools before finishing. if not, you can skip this step.

Note: For Multi-node environments (i.e. Separate workers and gallery nodes) follow the same process of each node.

Restore MongoDB Database

The next step is to restore your MongoDB database to the previous version.
  1. At this point the Alteryx Service should still be in a stop state.(check services.msc console to confirm). You can also stop the service via the cmd prompt as shown the example below
  2. Open Cmd Prompt and Execute the restore command 
    alteryxservice emongorestore=,
This example shows how to stop, restore and start the Alteryx service via the command line. For additional information on backup and restore process please review (Alteryx Server Backup and Recovery Part 2: Procedures )
"C:\Program Files\Alteryx\bin\AlteryxService.exe" stop
"C:\Program Files\Alteryx\bin\AlteryxService.exe" emongorestore=Z:\Path\MongoBackup,C:\ProgramData\Alteryx\Service\Persistence\MongoDB
"C:\Program Files\Alteryx\bin\AlteryxService.exe" start
  1. If the restore is successful you should see the following
The Mongo Database and application should now be fully restored.

Post Downgrade Checks

  • Check the gallery is accessible and the expected content (i.e. Users, Workflows, Schedules) has successfully restored
  • Check the Gallery logs for any unexpected locks (Locations for log files here ). In such instances please contact Alteryx Support to investigate further 
2020-05-11 15:53:06.564593,FATAL,18,QueueWorker,RunOnce,,,,LD-LT-241,,,,,,Lock obtain timed out: MongoDB.Lucene.MongoDocumentLock->Retry in (1) seconds...,"Lucene.Net.Store.LockObtainFailedException: Lock obtain timed out: MongoDB.Lucene.MongoDocumentLock-context, String name)
2020-05-11 15:33:59.700855,FATAL,20,QueueWorker,RunOnce,,,,LD-LT-241,,,,,,Failed to obtain IndexWriter lock.->Retry in (1) seconds...,System.Exception: Failed to obtain IndexWriter lock.
->   at Alteryx.Server.Models.BackgroundThread.QueueWorker.RunOnce()

Please Note: If you don't feel confident with the process please reach out to Alteryx Support for additional assistance. ​​​​​​



    Additional Resources