How to handle multiple Autory installations¶

There are several scenarios where you might have more than one version of Autory on the same computer:

You previously used Autory 2.x and have now installed Autory 3.x. See the upgrade guide.
You manually copied or moved Autory to a different location before installing another version. (Not recommended.)
You used a custom Autory installer.

Knowing which Autory installation is being used on the command line¶

Run autory debug from any terminal to see detailed info about which Autory version is being used, and where it is installed on your computer. Whenever you use a command like autory run ... from the terminal, this is the version of Autory that will be used.

If you want to use a different Autory installation on the command line, you must specify the full path to the autory.exe of that installation.

Choosing which Autory installation is used when starting a run from within Excel¶

Advanced topic

This is an advanced topic that most users will not need to worry about. The recommended approach is to always use the latest installed version of Autory.

When Autory is installed, an Autory ribbon appears in Excel. This ribbon is tied to the last version of Autory that was installed (ignoring old versions that do not yet have the ribbon feature).

Older versions of Autory (before 3.x) did not have the ribbon feature. Model workbooks created with older versions of Autory have a built-in "Save & Run" button instead.

Re-installing the ribbon (recommended)¶

Recommended

This is the recommended approach if you need to change which Autory installation is used in Excel without re-installing Autory completely.

Close Excel.
Find your alternative Autory installation folder.
Run the excel_addin/install.cmd script.
Open Excel. The Autory ribbon should now be tied to the Autory installation from which you ran the script.

Modifying the Autory ribbon config (advanced)¶

Not recommended

The ribbon that is installed with a specific version of Autory (e.g., 3.1) is not guaranteed to work with older or newer versions of Autory (e.g., 3.0), but it might. This approach is not recommended unless you know what you are doing.

Click the "Ribbon settings" button in the Autory ribbon.
This opens a config file in your default text editor. The file typically lives at C:\Users\user\AppData\Roaming\Microsoft\Excel\XLSTART\_autory\autory.conf and its contents typically look something like this:
```
"INTERPRETER_WIN","C:\Users\user\AppData\Local\autoactuary\autory3\bin\python\python\python.exe"
```
The INTERPRETER_WIN setting specifies the path to the Python interpreter that ships with Autory.
Modify this path to point to the python.exe of your desired Autory installation.
Save the file and close the text editor. There is no need to restart Excel.
When clicking "Save & Run" in the ribbon, the Autory installation defined in this config file will be used.

Using the "Save & Run" button in a model workbook (old)¶

Old method

This approach is applicable to older versions of Autory, which did not have the ribbon feature. It requires a model workbook that still has a built-in "Save & Run" button.

When using the "Save & Run" button in a model workbook, the AutoryAppDir run control option is used to determine which Autory installation to use, if it is set. Otherwise, the default Autory installation paths are searched for an appropriate version of Autory.