Linux: Install ApportoService

Install ApportoService on Linux

This guide walks you through installing and validating the ApportoService on Linux hosts, then registering the server in the Apporto portal. It mirrors the structure and clarity of the Windows install guide to provide a consistent operator experience.

Overview

The ApportoService on Linux enables secure management and brokering of RDP connections to Linux desktops and apps. APT-hosted packages and signed repositories make installation straightforward on Debian/Ubuntu-based distributions. This guide covers:

  • Prerequisites and network requirements

  • Repository setup and package installation

  • Service configuration and verification

  • Firewall rules and connectivity checks

  • Adding the Linux VM to the Apporto portal

Prerequisites

Customer-managed prerequisites ensure the VM is reachable and domain-integrated (where applicable) prior to installing ApportoService.

  • Linux VM (Debian/Ubuntu-based recommended) with administrative access (sudo or root).


  • SSH access enabled for administration.

  • RDP service enabled and configured on the Linux VM (e.g., xrdp) and tested.

  • Optional but recommended: Join the Linux VM to Active Directory and verify AD-based RDP logon using an RDP client.

Quick port checks (before and after install):
sudo ss -tunlp | grep :3389
sudo ss -tunlp | grep :50018

Install ApportoService (APT)

Run the following steps as root or with sudo.

Bash
# Switch to root (choose one)
su -
# or
sudo -i

# Prerequisites
apt-get update
apt-get install -y curl gpg

# Import Apporto GPG key
curl -fsSL "https://apporto-public-assets.s3.us-east-1.amazonaws.com/repo/gpg-key.pub" \
  | gpg --dearmor -o /usr/share/keyrings/apporto.gpg
chmod a+r /usr/share/keyrings/apporto.gpg

# Add the Apporto APT repo
echo "deb [signed-by=/usr/share/keyrings/apporto.gpg] https://apporto-public-assets.s3.us-east-1.amazonaws.com/repo stable main" \
  | tee /etc/apt/sources.list.d/apporto.list > /dev/null

# Update and install the service
apt-get update
apt-get install -y apportoservice-unix

Result: The apportoservice systemd unit is installed and ready to start. Repository signatures are validated via the imported key.

Validate Installation

1) Review systemd unit and environment

Bash
# Display the full unit file
systemctl cat apportoservice

# Optional: Narrow output to environment lines
systemctl cat apportoservice | grep -E "Environment=|EnvironmentFile="

2) Reload and check service status

Bash
# Reload systemd (only needed if unit files changed)
systemctl daemon-reload

# Start and enable service
systemctl enable --now apportoservice

# Verify status
systemctl status apportoservice --no-pager

3) Verify listening ports

Confirm the RDP service and ApportoService management port are listening:

Bash
sudo ss -tunlp | grep :3389
sudo ss -tunlp | grep :50018

Configure Firewall

If using UFW, allow required ports and confirm rules:

Bash
sudo ufw allow 3389/tcp
sudo ufw allow 50018/tcp
sudo ufw status

If you use another firewall (e.g., firewalld, iptables, or a cloud NACL/SG), replicate these allows there as well. Ensure egress HTTPS is permitted to the Apporto repo hosts.

Troubleshooting and Tips


    • Ensure xrdp or equivalent is installed and running: systemctl status xrdp

    • Confirm desktop environment is installed and configured for RDP sessions.

    • Verify firewall rules and upstream ACLs.


    • Check logs: journalctl -u apportoservice -n 200 --no-pager

    • Re-run systemctl daemon-reload if unit files were modified.


    • Confirm package is installed: dpkg -l | grep apportoservice-unix

    • Restart service: systemctl restart apportoservice

Register the Linux VM in Apporto Portal

Once the service is running and connectivity is verified, add the VM to the Apporto portal.

  1. Log in to the Apporto Portal as an MSP admin and navigate to the Servers node.

  2. Select either the Multi-Session or Single-Session tab based on your Linux distro’s capability.


    • Provisioning: Manually provisioned

    • Directory: Customer AD (AD Synced)

  3. Click Add Server, enter the Linux VM information and IP address, set Port to 3389, set OS to Linux, then Add Server.

  4. Go to the Desktop Pools node and click Create Desktop Pool. Name it, then Associate Server Pool with the pool created above.

  5. Go to the Apps and Desktops node and click Create App / Desktop. Provide a Name and Description (visible to users). Choose Type, click Add Group, select either All Users or the appropriate AD Groups. Click Add Group, then Save Changes.

  6. Navigate to the My Apps and Desktops node. You should see the published App/Desktop ready for launch.

Best Practices

  • Keep the system updated: apt-get update && apt-get upgrade -y on a maintenance schedule.

  • Restrict inbound access to TCP 3389 and 50018 to trusted sources or through private networking.

  • Use AD groups to manage user entitlements cleanly and consistently across apps/desktops.

  • Document server pool and desktop pool naming conventions to reduce administrative friction.

Reference Commands (Quick Copy)

Bash
# Ports and firewall
sudo ss -tunlp | grep :3389
sudo ss -tunlp | grep :50018
sudo ufw allow 3389/tcp
sudo ufw allow 50018/tcp
sudo ufw status

# Service review
systemctl cat apportoservice
systemctl enable --now apportoservice
systemctl status apportoservice --no-pager
journalctl -u apportoservice -n 200 --no-pager

Performing ApportoService Upgrades

  • Keep the ApportoService updated: sudo apt-get update && sudo apt-get install --only-upgrade apportoservice-unix on a suggested monthly schedule.

FAQ

Which Linux distributions are supported?

The APT-based instructions target Debian/Ubuntu derivatives. Other distributions may work using equivalent package and repository steps. Ensure RDP and firewall configuration match the requirements listed above.

Do I need AD domain join for Linux?

It is recommended for consistent identity and authorization, especially for multi-user environments. You can use SSSD/realmd to join AD and verify RDP logons using AD credentials before adding the VM to the portal.

What ports must be open?

Inbound TCP 3389 (RDP) and TCP 50018 (ApportoService management) to the VM, and outbound HTTPS to the Apporto repository and assets.

References