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 (
sudoorroot). -
-
Inbound RDP: TCP 3389 (to the Linux VM)
-
Inbound management: TCP 50018 (ApportoService)
-
Egress HTTPS to Apporto repo and assets: https://apporto-public-assets.s3.us-east-1.amazonaws.com/repo and https://github.com/apportocorp/apportoservice-unix
-
-
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.
# 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
# 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
# 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:
sudo ss -tunlp | grep :3389
sudo ss -tunlp | grep :50018
Configure Firewall
If using UFW, allow required ports and confirm rules:
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-reloadif 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.
-
Log in to the Apporto Portal as an MSP admin and navigate to the Servers node.
-
Select either the Multi-Session or Single-Session tab based on your Linux distro’s capability.
-
-
Provisioning: Manually provisioned
-
Directory: Customer AD (AD Synced)
-
-
Click Add Server, enter the Linux VM information and IP address, set Port to 3389, set OS to Linux, then Add Server.
-
Go to the Desktop Pools node and click Create Desktop Pool. Name it, then Associate Server Pool with the pool created above.
-
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.
-
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 -yon 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)
# 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-unixon a suggested monthly schedule.