Install StoreFront
Before installing
Before you install and configure StoreFront, review the System Requirements.
Install StoreFront
Important
To avoid potential errors and data loss when installing StoreFront, ensure all applications are closed and no other tasks or operations are running on the target system.
-
Download the installer from the StoreFront download page. The installer can also be found on the Citrix Virtual Apps and Desktops image in the
\x64\Storefrontdirectory. -
Log on to the StoreFront server using an account with local administrator permissions.
-
Locate CitrixStoreFront-x64.exe, and run the file as an administrator.
-
Read and accept the license agreement, and click Next.
-
If the Review prerequisites page appears, click Next.
-
On the Ready to install page, check the prerequisites and StoreFront components that are listed for installation and click Install.
-
When the installation is complete, click Finish.
-
StoreFront may ask to reboot to complete the installation. Click Yes to reboot now.
-
Configure Microsoft Internet Information Services (IIS) for HTTPS. For steps see Securing StoreFront with HTTPS.
To install StoreFront at a command prompt
-
Log on to the StoreFront server using an account with local administrator permissions.
-
Browse your installation media or download package, locate CitrixStoreFront-x64.exe, and copy the file to a temporary location on the server.
-
At a command prompt, navigate to the folder containing the installation file and type the following command.
CitrixStoreFront-x64.exe [-silent] [-INSTALLDIR installationlocation] [-WINDOWS_CLIENT filelocation\filename.exe] [-MAC_CLIENT filelocation\filename.dmg] <!--NeedCopy-->Use the -silent argument to silently install StoreFront and its prerequisites. By default, StoreFront is installed at C:\Program Files\Citrix\Receiver StoreFront. However, you can specify a different installation location using the -INSTALLDIR argument, where installationlocation is the directory in which to install StoreFront. If you intend the server to be part of a server group, both the StoreFront installation location and IIS website settings, physical path and site IDs must be consistent across them.
When a user opens a store in a web browser on Windows or macOS, by default, if it cannot detect Citrix Workspace app, it prompts the user to download and install the appropriate Citrix Workspace app for their platform from the Citrix website. You can modify this behavior so that users download the Citrix Workspace app installation files from the StoreFront server instead. For more information, see Configure how resources are displayed for users.
If you plan to make this configuration change, specify the -WINDOWS_CLIENT and -MAC_CLIENT arguments to copy Citrix Receiver for Windows or Citrix Workspace app for Windows, and Citrix Receiver for Mac or Citrix Workspace app for Mac installation files, respectively, to the appropriate location in your StoreFront deployment. Replace filelocation with the directory containing the installation file that you want to copy, and filename with the name of the installation file. Citrix Workspace app for Windows, and Citrix Receiver for Mac or Citrix Workspace app for Mac installation files are included on your Citrix Virtual Apps and Desktops installation media.
.Net Framework 4.8 reboot step with Windows Server 2019
The .Net Framework 4.8 is a pre-installed component on Windows Server 2022 but not on Windows Server 2019. The CitrixStoreFront-x64.exe installer runs the .Net Framework 4.8 installer if it’s not present. If existing .Net Framework libraries are in use, a server reboot may be required for the .Net Framework 4.8 install to complete before StoreFront can be installed. This may occur if you have a PowerShell session running.
When a reboot is required the CitrixStoreFront-x64.exe will exit and will need to be manually restarted afterwards. If the install is in silent mode it will exit with an error code otherwise the user will be prompted to allow reboot. The CitrixStoreFront-x64.exe process will return any non success exit code from the .Net Framework 4.8 installer in those situations. The specific reboot exit codes are:
- ERROR_SUCCESS_REBOOT_REQUIRED 3010
- ERROR_SUCCESS_REBOOT_INITIATED 1641
For silent installation of CitrixStoreFront-x64.exe via PowerShell script, pre-install .Net Framework 4.8 on the server if it’s not already present.
Installing as part of Citrix Virtual Apps and Desktops
You can install StoreFront on the same server as Citrix Virtual Apps and Desktops. Run the Citrix Virtual Apps and Desktops installer and under Extend Deployment choose Citrix StoreFront.
Installation logs
For more details of logs files, see Installation Logs.
Configure StoreFront
When you complete installation, the Citrix StoreFront management console starts automatically. You can also open StoreFront from the Start menu. When the Citrix StoreFront management console first starts, two options are available.
-
Create a deployment. Configure the first server in a new StoreFront deployment. Single-server deployments are ideal for evaluating StoreFront or for small production deployments. Once you have configured your first StoreFront server, you can add more servers to the group at any time to increase the capacity of your deployment.
-
Join existing server group. Add another server to an existing StoreFront deployment. Select this option to rapidly increase the capacity of your StoreFront deployment. External load balancing is required for multiple server deployments. To add a server, you need access to an existing server in the deployment.
Your store is now available for users to access through a browser or locally installed Citrix Workspace app. See the User experience.