Installing on a Virtual Linux Server¶

If you want to install Getscreen.me on a virtual private server (VPS) and launch remote access on Linux, use the following recommendations.

Creating a user¶

First you need to access the VPS and create a user under whose name you are going to work. In our example, this is getscreen.

adduser getscreen
usermod -aG sudo getscreen

Installation and setup¶

To let Getscreen.me work without an explicit (graphical) user login, create a virtual X11 server Xfce & Getscreen.me are to work on.

Xvfb server¶

First install the Xvfb virtual server:

sudo apt-get install xvfb

Next, create the file in /etc/systemd/system/xvfb.service

sudo nano /etc/systemd/system/xvfb.service

and describe the service:

[Unit]
Description=X virtual framebuffer
[Service]
Type=simple
User=getscreen
ExecStart=/usr/bin/Xvfb :99 -screen 0 1440x900x24 -ac
[Install]
WantedBy=multi-user.target

A virtual screen with a resolution of 1440x900 or other values can be used for work.

Xfce4 terminal¶

Specify the following data to install the Xfce4 terminal emulator:

sudo apt-get install xfce4 xfce4-goodies libappindicator3-1
libwebkit2gtk-4.0

Next, create the service for launching the terminal:

sudo nano /etc/systemd/system/xfce4.service

with the following content:

[Unit]
Description=XFCE4
Requires=xvfb.service
After=xvfb.service
[Service]
Type=simple
User=getscreen
WorkingDirectory=/home/getscreen/
Environment="DISPLAY=:99"
ExecStart=/usr/bin/startxfce4
[Install]
WantedBy=multi-user.target

Installing Getscreen.me¶

Download Getscreen.me:

wget https://getscreen.me/download/getscreen.me.deb

Install:

sudo apt-get install ./getscreen.me.deb

Set up a username and a password to connect to an account:

/opt/getscreen.me/getscreen.me setup

Create the getscreen.me service:

sudo nano /etc/systemd/system/getscreen.me.service

and describe it:

[Unit]
Description=Getscreen.me
Requires=xfce4.service
After=xfce4.service
[Service]
Type=simple
User=getscreen
WorkingDirectory=/home/getscreen/
Environment="DISPLAY=:99"
ExecStart=/opt/getscreen.me/getscreen.me
Restart=on-failure
RestartSec=60s
[Install]
WantedBy=multi-user.target

Launching the services¶

To launch the services, perform:

sudo systemctl daemon-reload
sudo systemctl enable getscreen.me
sudo systemctl start xvfb
sudo systemctl start xfce4
sudo systemctl start getscreen.me

The sudo systemctl enable getscreen.me string automatically launches the service at the system startup.

Updating Getscreen.me¶

To update the agent, create the script:

nano ~/getscreen.update.sh

Set the following data in the script:

#!/bin/bash

# delete update
rm -F getscreen.me.update

# download update
wget https://getscreen.me/download/getscreen.me -O
getscreen.me.update || exit 1

# stop service
sudo systemctl stop getscreen.me || exit 2

# update
sudo cp getscreen.me.update /opt/getscreen.me/getscreen.me || exit 3

# start service
sudo systemctl start getscreen.me || exit 4
echo "getscreen have been updated"

Call the script to perform an update:

sh ~/getscreen.update.sh

If you have any ideas, feel free to share them on the suggestions page, or contact us or at info@getscreen.me