Skip to main content
Guide menu

Install and update

TCS-NET installs on Windows, Linux and macOS. The app looks for new versions and updates without losing data.

Requirements

  • Windows, Linux or macOS. Windows 10 or newer; Linux on a 64-bit PC (Ubuntu 22.04 or newer, Debian and similar); macOS on a Mac with an Apple silicon or an Intel processor.
  • No administrator rights on Windows. TCS-NET installs for the current user only. On Linux the .deb file asks for your password once; the AppImage needs none.
  • Space. The Windows installer is about 120 MB and takes about 430 MB once installed. The size of each file is shown on the download page.

Install on Windows

  1. 01

    Download the installer

    Open the Download TCS-NET page and download TCS-NET-Setup-<version>.exe. The page shows the file's SHA-256, which you can use to check that the download arrived intact.

  2. 02

    Run the installer

    Windows may show Windows protected your PC because the installer is not digitally signed. Choose More info, then Run anyway.

  3. 03

    Choose the folder

    You can keep the default folder. The installer speaks English or Vietnamese, following the Windows display language.

  4. 04

    Finish

    The background service starts at once and the app opens.

  5. 05

    Create the administrator account

    On the first start the app shows Create the admin account. It is the only administrator account of the gateway; use it to sign in from the app and from the web interface.

Antivirus software

Some antivirus programs raise a false alarm on programs that are not signed. If a file is blocked or quarantined, restore it, add an exclusion for the install folder and for the TCS-NET data folder, and install again.

Install on Linux

  1. 01

    Download the file

    Open the Download TCS-NET page and download the .deb file (Ubuntu, Debian and similar). If your system cannot open a .deb file, download the AppImage instead. The page shows each file's SHA-256.

  2. 02

    Install it

    Open the downloaded .deb file with Software (or App Center) and press Install. Enter your password when asked. For the AppImage: right-click the file, open Properties, Permissions, turn on Allow executing file as program, then double-click it.

  3. 03

    Open TCS-NET

    Find TCS-NET in the applications menu. The background service starts at once, and the app asks once whether it should start whenever you sign in.

  4. 04

    Create the administrator account

    On the first start the app shows Create the admin account. It is the only administrator account of the gateway; use it to sign in from the app and from the web interface.

Ubuntu 24.04 and newer

Use the .deb file on these versions: the AppImage may not open there.

Serial ports

To read devices through a USB serial adapter (Modbus RTU), your account must be allowed to use serial ports. Ask your system administrator, then sign out and in again.

Install on macOS

  1. 01

    Pick the file for your Mac

    On the Download TCS-NET page choose Apple silicon (Macs with an M1 chip or newer) or Intel. To check, open the Apple menu, About This Mac, and look at Chip or Processor.

  2. 02

    Open the file

    Open the downloaded .dmg file and drag TCS-NET onto Applications.

  3. 03

    Open TCS-NET the first time

    macOS may say it cannot verify TCS-NET because the app is not notarized by Apple yet. Open System Settings, Privacy & Security, find the message about TCS-NET and press Open Anyway. On older macOS, right-click the app and choose Open. You only do this once.

  4. 04

    Create the administrator account

    On the first start the app shows Create the admin account. It is the only administrator account of the gateway; use it to sign in from the app and from the web interface.

The background service starts at once, and the app asks once whether it should start whenever you sign in. Your data is kept apart and is not deleted by an update or an uninstall.

What the Windows installation creates

ShortcutWhat it does
TCS-NET (desktop and Start menu)Opens the app.
TCS-NET Start BackendStarts the background service again if you stopped it.
TCS-NET Open WebStarts the background service if needed and opens the web interface in the browser.
Uninstall TCS-NETUninstalls.

The background service starts when you sign in to Windows, so collection does not depend on the app window. Your data is kept apart and is not deleted by an update or an uninstall.

Update

The app looks for a newer version when you open it and from time to time while it runs. With no internet connection it quietly gives up. When one is found, a notice appears and the title bar shows an Update available chip with the version.

  1. 01

    Open Updates

    Click the chip in the title bar, or go to Configuration, Basic Configuration, Updates.

  2. 02

    Download the update

    Press Download update. A progress bar shows how much has arrived.

  3. 03

    Restart

    Press Restart and install. The app opens again when it is done.

An update replaces the app and the background service and keeps all your data. Collection pauses for a few minutes while it installs. Nothing is downloaded or installed until you press.

Updating by hand

You can always download the newest installer from the Download TCS-NET page and run it over the old one: your data is kept. The first version that has self-update must be installed by hand once.

Linux and macOS

The app updates itself as described above on Windows and with the Linux AppImage. With the Linux .deb file and on macOS, download the newest file from the Download TCS-NET page and install it over the old one, the same way you installed the first: your data is kept.

Uninstall

Windows: go to Settings, Apps, or the Start menu, TCS-NET, Uninstall TCS-NET. Linux: open Software (or App Center), find TCS-NET and choose Uninstall; for the AppImage, delete the file. macOS: drag TCS-NET from Applications to the Bin.

Your data is kept

Your data is not deleted when you uninstall, so you can install again without losing anything. To remove it completely, contact us and we will guide you.