This article forms part of the Attache Installation and Upgrade process. Following the steps in this article would be as part of an installation/upgrade of Attaché, or as a re-install specifically directed by an Attaché Support engineer to resolve a current issue.
If you are installing or upgrading Attaché, please refer to the Attaché: Installation and Upgrade Guide.
📌 Important Notes:
You must upgrade Attaché Database Server before you upgrade the Attaché desktop application if you are performing a full install or upgrade of Attaché.
Attaché requires Microsoft .NET Framework version 4.7.2, .NET Core 2.1 and ASP .NET Core 2.1. (Previously .NET 4.5.2 was required.) These have been packaged with the InstallShield wizard. When installing Attaché, you will be prompted to install .NET 4.7.2, .NET Core 2.1 and ASP .NET Core 2.1 if these items are not already installed.
Attaché checks and processes before you install, re-install or upgrade the Attaché application
If you are upgrading the Attaché application from a previous version
From within Attaché, go to Help, About Attaché and make a note of the Program Folder location to Install the Attaché application.
Make a note of every location (for example, PC, laptop and workstation) from where Attaché will be run.
Post any outstanding transactions to the general ledger. The attaché workstation install will need to be run on every location.
Take a backup of your Attaché data. See: Create an archive and find the archive file.
Exit Attaché and ensure that no one else is using it.
If you are re-installing the Attaché application as directed by an Attaché support engineer
From within Attaché, go to Help, About Attaché and make a note of the Program Folder location to Install the Attaché application.
Take a backup of your Attaché data. See link to Create an archive and find the archive file above.
Exit Attaché and ensure that no one else is using it.
If you are performing a new installation of the Attaché application
In Windows Explorer, navigate to the drive where the Attaché application will be installed.
On the server or computer, you are installing Attaché on, create a new folder C:\Apps\AttacheDesktop. This folder will act as the root directory for the Attaché application, known as the Program Folder.
Use Windows Explorer's File Sharing tool to share the C:\Apps folder with all Attaché users. You are now ready to begin the installation.
Installing the Attaché application on Windows 10 or Windows 11
To install the Attaché application on Windows 10 or Windows 11:
Right-click on the installation file (for example, ATxxx.exe) and select Run as administrator.
If prompted by the User Account Control, select Yes.
If prompted by Windows Smart Screen, click More info and choose Run anyway.
The Installation Wizard will now run. When prompted, click Next.
Select Custom and click Next.
Select the installation location:
If a new install, select C:\Apps\AttacheDesktop folder as the location to install the Attaché application to and click Next.
If you are upgrading or re-installing the Attache application, enter the existing Program Folder location as per Attaché checks and processes steps above.
Select Install.
Once the installation is complete, click the Finish button.
Installing the Attaché application on Windows Server 2016 /2019 / 2022
Installing with Remote Desktop Services enabled
To install the Attaché application on Windows Server 2016 / 2019 / 2022 with Remote Desktop Services enabled:
Please refer to From the Modern UI screen, open the Control Panel.
Select Install Application on Remote Desktop Server
Click Next
Windows will prompt you to browse to the installation program. Select Browse.
From the drop-down menu on the right, select All Files.
Navigate to the location of the Attaché installation file (for example, ATxxx.exe), select it and click Open.
Click Next.
The Installation Wizard will now run.When prompted, click Next.
Select Custom and click Next.
Select the installation location:
If a new install, select C:\Apps\AttacheDesktop folder as the location to install the Attaché application to and click Next.
If you are upgrading or re-installing the Attache application, enter the existing Program Folder location as per Attaché checks and processes steps above.
Once the installation is complete, click the Finish button.
Click the Finish button on the Admin Install Wizard.
Installing with Remote Desktop Services disabled
To install the Attaché application on Windows Server 2016 / 2019 / 2022 with Remote Desktop Services disabled:
Right-click on the installation file (for example, ATxxx.exe) and select Run as administrator.
If prompted by the User Account Control, select Yes.
If prompted by Windows Smart Screen, click More info and choose Run anyway.
The Installation Wizard will now run. When prompted, click Next.
Select Custom and click Next.
Select the installation location:
If a new install, select C:\Apps\AttacheDesktop folder as the location to install the Attaché application to and click Next.
If you are upgrading or re-installing the Attache application, enter the existing Program Folder location as per Attaché checks and processes steps above.
Select Install.
Once the installation is complete, click the Finish button.