Shinydocs Pro

Shinydocs Pro Installation Guide

Ensure that the Shinydocs Pro Pre-Installation Checklist has been followed and the hardware meets or exceeds the requirements before beginning the setup process.

image-20250903-152719.png

These steps have been completed on a fresh installation of Windows Server 2022, with some basic administrative tools installed, such as Chocolatey, Notepad++, 7-Zip, and WinMerge for convenience, but these are not prerequisites.

Pre-installation Reading

Suggested Tools

These tools, when installed on the server, help with the success of installation and troubleshooting.

• Notepad++ (64-bit)
• 7-Zip

Prerequisites

Shinydocs Pro Pre-installation Checklist

  • The main item to note here is that we recommend using a service account with read (for scanning) and write (for file deletion) access.

  • Endpoint Protection Considerations for Shinydocs Pro

  • The Shinydocs Pro Service Account

    • A domain account, or a group managed service account (gMSA), with read rights to all files and folders of the file shares that will be targeted. To delete files with disposal, it also needs permission to delete them.

    • If Search will check file permissions, the Shinydocs Control Center service runs as this account, so it must be a local administrator on the Shinydocs Pro server.

    • The setup should be performed using this account to ensure access is established.

    • It doesn’t need interactive logon rights. See How to configure the Windows Service Account for use with Shinydocs Pro.

Final Checklist

Please ensure that the user account to initiate this installation, the logged-on user, is the Windows Domain Service Account created as a prerequisite.

Download and/or copy the installation file to the target server as the service account user.

Download and/or copy the provided license (.xml) file to the target server as the service account user.

Downloading the Installer and Starting Setup

  1. Ensure a service account is created for use by the services, while uncommon to do so, the username cannot be the same as the server name.

  2. Download the Shinydocs Pro installer and place in the Downloads folder on the new Shinydocs Pro Server. You will be provided a download URL by Shinydocs Customer Support.

    image-20250903-145654.png


  3. Once completed, locate the downloaded file.

    image-20250903-151709.png


  4. Right-Click on the file and open Properties…

    image-20250903-151852.png


  5. Select Unblock, then OK to unblock the file. This is an important step.

    image-20250903-152111.png


  6. Double-click the Shinydocs Pro installer to begin. Setup shows the install location, the components and the license agreement on one screen.

    Shinydocs Pro Setup


Important: Shinydocs Pro needs disk space for indexing and analysis. Install it on a data drive that isn’t the operating system drive, for example E:\, with free space of at least 10% of your estimated content size.

  1. In Install location, keep the default, C:\Program Files\Shinydocs Professional, or click Browse to choose a folder on your data drive.

    If this is an upgrade and you change the install location, you must either copy the data folder from the previous Search Engine install or update opensearch.yml to use the old data folder. See Relocating the Shinydocs Search Engine Data Folder.

    Leave Install Shinydocs Dashboards and Install Shinydocs Search Engine (required for single machine install) selected unless Shinydocs Support has told you otherwise.

  2. Read the license agreement, select I agree to the license terms and conditions, then click Install.

  3. Windows Server will verify elevated access

    image-20250903-154341.png


  4. The install will commence…

    image-20250903-154421.png


  5. You may be prompted for any prerequisites as necessary, the full installation may take up to 40 minutes, but is often less. An active endpoint protection tool, such as anti-malware or anti-virus, can slow things down though.

    image-20250903-154831.png
    image-20250903-154917.png
    image-20250903-154948.png

    Please approve these manually to proceed.

  6. The Shinydocs Dashboards will take a significant amount of time (~20 minutes), in the background the installer is unpacking many small files and this is time consuming.

    image-20250903-155459.png


  7. Almost done…

    image-20250903-173557.png


  8. The installation is complete. Click on Launch Shinydocs Pro…

    image-20250903-190335.png


  9. If available, locate and load your license file, click on Choose file.

    image-20250903-190831.png


  10. Click Next…

    image-20250903-191149.png


  11. We recommend our customers start with a file share to become familiar with the features of Shinydocs Pro. More information is available here: Configure Content Sources

  12. Shinydocs Pro is now installed.

:info:

Important
Please follow this article to ensure OpenSearch is provisioned properly for your system:
Increasing Search Engine Service Memory Allocation (Heap Size)


Further Reading: Shinydocs Pro Control Center Guide