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
- 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. - 02
Run the installer
Windows may show Windows protected your PC because the installer is not digitally signed. Choose More info, then Run anyway.
- 03
Choose the folder
You can keep the default folder. The installer speaks English or Vietnamese, following the Windows display language.
- 04
Finish
The background service starts at once and the app opens.
- 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
- 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.
- 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.
- 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.
- 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
- 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.
- 02
Open the file
Open the downloaded .dmg file and drag TCS-NET onto Applications.
- 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.
- 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
| Shortcut | What it does |
|---|---|
| TCS-NET (desktop and Start menu) | Opens the app. |
| TCS-NET Start Backend | Starts the background service again if you stopped it. |
| TCS-NET Open Web | Starts the background service if needed and opens the web interface in the browser. |
| Uninstall TCS-NET | Uninstalls. |
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.
- 01
Open Updates
Click the chip in the title bar, or go to Configuration, Basic Configuration, Updates.
- 02
Download the update
Press Download update. A progress bar shows how much has arrived.
- 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.