Quick-start guide

Preface

This guide will help you get started installing ThinLinc after downloading theThinLinc server bundle. The installation of ThinLinc server is a guided installation and setup wizard that walks you through the installation and initial configuration. A typical ThinLinc installation will not require more than 1015 minutes of your time. For more detailed instructions, refer to the administrator's guide.

Software requirements

As long as your platform fulfills the requirements listed in3.2. Requirementsin the administrator's guide,ThinLinc should work as expected. The server installer will try to resolve the required dependencies automatically and will prompt you for handling these.

Desktop environment

Make sure you have installed a desktop environment, such as Xfce, LXDE, MATE or other. Please refer to your distribution documentation for how to install these. For best performance, we recommend installing a more lightweight desktop environment withoutcompositing.

Unpacking the ZIP file

After you have obtained and downloaded ThinLinc, unpack the ZIP file by right-clicking and selecting Extract. You can also unpack it from a command prompt:

$ unzip tl-4.21.0-server.zip

Installing ThinLinc server

Before starting the installation program, review ourplatform specific notesto see if there is anything specific to your Linux distribution that you might need to be aware of. The installation has two parts; the first, install-server will install the ThinLinc package appropriate for your platform RPM or DPKG. When this task has completed, ThinLinc will be configured. This is done with the tl-setup command and install-server will ask about starting ThinLinc Setup automatically at the end of the package installation. You can invoke the graphical installation of ThinLinc by double-clicking on install-server. You can also start the installation from a command prompt:

$ cd tl-4.21.0-server
$ ./install-server

Follow the simple installation instructions, and you will soon haveinstalled and configured ThinLinc server on your machine. If you encounter any errors or have questions regarding this part of ThinLinc, we encourage you to join ourThinLinc communitywhere you can ask questions and interact with other ThinLinc administrators & users.

Verifying the installation

After the installation has finished, you can verifiy that the ThinLinc server services have been started correctly with the systemctl command

$ sudo systemctl status vsmserver
$ sudo systemctl status vsmagent
$ sudo systemctl status tlwebaccess

All services should be reporting Active: active (running). If some or all services have failed to start, you should investigate your system's journal with journalctl and/or investigate the ThinLinc server logfiles which can provide information on why they failed to start.

• /var/log/vsmserver.log
• /var/log/vsmagent.log
• /var/log/tlwebaccess.log

Access a ThinLinc server behind NAT

Need help?

We hope that most of the questions that might occur during installation are answered in theadministrator's guide. Use the search box at the right top of Cendio's webpages to search for keywords. If you can't find the answers to your questions, don't hesitate to join and ask questions on theThinLinc mailing listsor theThinLinc community. You can also contact ourdemo support. For more troubleshooting tips, please seeAppendix B. Troubleshooting ThinLinc.

Getting started with the client

When the installation program has ended, your server should be running a ThinLinc Server, and you should be able to connect to it using a ThinLinc client. We provide clients for all major operating systems (GNU/Linux, macOS and Windows). You find clients suitable for your machines on ourclient download page. The client devices access the ThinLinc server and get their Remote Linux Desktop using two methods: The ThinLinc native client The ThinLinc native clients require the client device to have access to port 22 (SSH) on the server and are compatible with GNU/Linux, macOS andWindows. Or: The Web Access is an HTML5-based web client compatible with all majorbrowsers and is accessible on "https://your.ip:300", requiring in this case access to port 300 (web access) on the ThinLinc server. SeeAppendix A. TCP Ports Used by ThinLincfor more information.