Installation Mode

Select Required Features

Check the features you need to enable. Only the relevant installation steps will be shown.

Installation Steps

  1. Download and Extract

    Download the version that you would like from the releases page (use the "Service" download) (use the "Standalone" download), and extract the ZIP file. Copy the executable called TarasaGateway.WindowsService.exe TarasaGateway.Client.exe and the json file called client-settings.json to %programfiles%/TarasaGateway/, which is likely C:/Program Files/TarasaGateway. If this is your first time, you'll need to create this folder. Ensure the folder name is exactly TarasaGateway. a folder of your choice.

  2. Configure Settings

    In the TarasaGateway folder, open the file named client-settings.json in a text editor (Notepad works fine), and:

    1. Change the ServerUrl to the URL of the Tarasa application, including the /api/ suffix, for example https://www.example.com/api/
    2. Change the ApiKey to the API key of the user that should be used to connect to the gateway.
    3. Add the IntegrateUrl setting with the URL to your Flexpoint Integrate server, for example http://localhost:9995/integrate
    4. Add the FileLocationWhitelist setting to control which files and folders the Tarasa Gateway Client is allowed to manage — see the dedicated step below for how this works.
  3. Install and Configure FlexpointFLEXPOINT

    To enable Flexpoint functionality, you need to install Flexpoint and ensure the Flexpoint Integrate server is running.

    1. Install Flexpoint on the machine running the Tarasa Gateway Client
    2. Start the Flexpoint Integrate service
    3. Verify it is accessible at the URL you configured in client-settings.json
  4. Install Ghostscript for PDF PrintingPDF PRINTING

    To enable PDF printing functionality, you'll need to manually install Ghostscript. Download the latest version of Ghostscript from https://www.ghostscript.com/download/gsdnld.html, and install it. Make sure it is installed in the "Program Files" folder, or that the "bin" directory is added to the PATH.

  5. Install Microsoft Word for Word to PDF ConversionWORD TO PDF

    To enable Word to PDF conversion functionality, you need to have Microsoft Word installed locally on the machine running the Tarasa Gateway Client. The gateway will use Word's COM automation to perform the conversion.

  6. Configure Firewall for WebRTCWEBRTC

    To enable local device connections via WebRTC, you need to allow outgoing connections in any firewall, including Windows Firewall.

  7. Configure File Access (FileLocationWhitelist)MANAGING FILES

    When the Tarasa server needs the gateway client to read, write, or list a file on this machine — for example to save an uploaded document, or fetch a report for someone — it does so through a command called ManageFile. Which files that command is allowed to touch is controlled entirely by the FileLocationWhitelist setting in client-settings.json. Anything not covered by it is refused.

    FileLocationWhitelist is a list of entries. Each entry has three parts:

    • Alias — the entry's name (e.g. "Logs", "Uitwisseling") is not a folder path, it's a label. The Tarasa server refers to files using this label, so the exact same spelling must also be configured on the Tarasa server side. Two different gateway clients can use the same alias name to point at two completely different folders — the alias is just the shared vocabulary between server and client, not the location itself. This is useful, because the server does not need to know anything of the file system of the pc that runs that gateway client.
    • Root is the actual folder on this machine that the alias points to. It can be an absolute path, or a path relative to the Tarasa Gateway Client's working directory.
    • Permissions lists, as single letters, which actions are allowed inside that folder: c create, r read, w write (overwrite), a append, d delete, l list. Combine as many as needed, in any order, e.g. "rwad". A single request from the server can need more than one letter at once — for example, "create this file if it doesn't exist yet, otherwise add to the end of it" needs both c and a present. Having only one of the two means that request is refused whenever the file happens to be in the state the missing letter would have covered.

    Example — two aliases with different access levels:

    "FileLocationWhitelist": {
      "Uitwisseling": {
        "Root": "D:/tarasa/uitwisseling/",
        "Permissions": "crwad"
      },
      "Logs": {
        "Root": "./logs/",
        "Permissions": "rl"
      }
    }

    Here, "Uitwisseling" is a full-access alias pointing at a folder on the D: drive: the server can create, read, overwrite, append to, and delete files inside it. "Logs" only allows reading and listing inside the gateway client's own logs folder — the server can look at log files, but can't change or delete them.

  8. Create Windows Service

    Open a command prompt as administrator, and run these two commands:

    1. Basic installation (default settings):
      sc.exe create "Tarasa Gateway" binpath= "C:\Program Files\TarasaGateway\TarasaGateway.WindowsService.exe" start=auto
    2. With custom configuration and log paths (optional):
      sc.exe create "Tarasa Gateway" binpath= "\"C:\Program Files\TarasaGateway\TarasaGateway.WindowsService.exe\" --config my-settings.json --log mylogs" start=auto
    3. Configure failure recovery:
      sc.exe failure "Tarasa Gateway" reset=0 actions=restart/60000/restart/60000/run/1000

    Note: Choose either option 1 (default) or option 2 (custom paths), not both. Then run option 3 to configure failure recovery.

  9. Start the Service
    1. Open the services control panel (use Windows-R and then type services.msc)
    2. Find the service named "Tarasa Gateway" and start it
  10. Run the Application

    Double-click TarasaGateway.Client.exe to run the gateway client. The application will run in the foreground and you can close it by closing the console window.

    Using Command-Line Parameters:

    To use custom configuration or log paths, open a command prompt in the gateway folder and run:

    TarasaGateway.Client.exe --config my-settings.json --log mylogs
  11. Verify Installation

    If successful, a new logs folder will appear in the gateway installation folder (C:\Program Files\TarasaGateway\logs) (in the same folder as the executable), or in the custom location if you specified the --log parameter. Inside, there should be a txt file with an entry like:

    2024-06-18 14:34:39.217 +02:00 [INF] Registered with server

    This confirms that the gateway has successfully connected to the Tarasa application.

Troubleshooting