Installation Guide

Step-by-step instructions for installing the server and client, and required ports reference.

Step 1

Server Installation

Set up the Remotto management server

Windows

Download the Installer

Download the Remotto Server (Windows) installer.

Download

ℹ️ SHA-256 Hash Verification
Verify file integrity by comparing the hash value below with the output of the command.
b3f056a73ae3edabe1d61805a0a2548a97f1d10c4908232b0f48224e517370be

# Run in PowerShell
Get-FileHash .\RemottoServerSetup.exe -Algorithm SHA256 | Format-List

Run the Installer

Run the downloaded installer with administrator privileges. Follow the on-screen instructions to complete the installation.

Specify the installation directory
Automatically registered as a Windows service
Firewall rules are added automatically

PostgreSQL Tuning (Recommended)

We recommend tuning PostgreSQL based on your device count. Edit postgresql.conf (typically at C:\Program Files\PostgreSQL\{version}\data\postgresql.conf).

# Recommended for 4GB RAM / 50-200 devices
shared_buffers = 512MB
effective_cache_size = 2GB
work_mem = 4MB
maintenance_work_mem = 128MB
max_connections = 100

# Recommended for 8GB RAM / 200-500 devices
shared_buffers = 2GB
effective_cache_size = 4GB
work_mem = 8MB
maintenance_work_mem = 256MB
max_connections = 150

# For 16GB+ RAM / 500-1000 devices
shared_buffers = 4GB
effective_cache_size = 8GB
work_mem = 16MB
maintenance_work_mem = 512MB
max_connections = 200

💡 Restart the PostgreSQL Windows service after changes. On Linux, remotto-server retune-db handles this automatically.

Linux (Ubuntu 24.04 / Debian 13 / Rocky Linux 10.1)

Download and Install the Package

Download the Remotto Server (Linux) package and install. Dependencies (including PostgreSQL) are installed automatically.

Download

# Ubuntu 24.04 / Debian 13
sudo apt install ./remotto-server_*.deb

# Rocky Linux 10.1
sudo dnf install ./remotto-server_*.rpm

ℹ️ SHA-256 Hash Verification
Verify file integrity by comparing the hash values below with the output of the command.
deb: ad4935a11793f75f55f53954c3455fb22e004194b2ff99bda1e387aaaa38d58b
rpm: bfbbdd000df4db913e35233a0b971531c56c217949784351c18e2b1c2af2e4d5

# SHA-256 hash verification
sha256sum remotto-server_*.deb

ℹ️ The following are configured automatically:

PostgreSQL database initialization, creation & tuning
JWT secret generation
Streaming API key generation and synchronization
Network configuration (public_url) auto-detection
All services started

Verify Installation

Access the admin console in your browser to verify the server is running correctly.

# Check service status
sudo systemctl status remotto-server

# Access the admin console in your browser
http://<server-ip-address>:8080

💡 Default login: Username admin / Password admin123 (please change after first login)

Configure the Firewall

Open the required ports.

# firewalld (Rocky Linux 10.1)
sudo firewall-cmd –permanent –add-port=8080/tcp
sudo firewall-cmd –permanent –add-port=7880/tcp
sudo firewall-cmd –permanent –add-port=7882-7892/udp
sudo firewall-cmd –reload

# ufw (Ubuntu)
sudo ufw allow 8080/tcp
sudo ufw allow 7880/tcp
sudo ufw allow 7882:7892/udp

Management Commands

Remotto Server provides CLI management commands for administration.

# Auto-tune PostgreSQL (optimizes based on server RAM)
sudo remotto-server retune-db

# Update config after server IP change
sudo remotto-server update-ip

💡 retune-db — Run in the following cases:
• After upgrading server RAM
• After significant changes in managed device count (e.g., 50 → 200)
• When database response feels slow
Automatically detects RAM and optimizes PostgreSQL performance settings.

💡 update-ip — Run in the following cases:
• After changing the server IP address
Automatically updates IP addresses in config files and restarts services.

Step 2

Client Installation

Install the client on managed Windows PCs

Download the Installer

Download the Remotto Client (Windows) installer.

Download

ℹ️ SHA-256 Hash Verification
Verify file integrity by comparing the hash value below with the output of the command.
7fc11dab1390611aea48754a8a39109f4f92cf1e3709df9220ba6914606aa3a4

# Run in PowerShell
Get-FileHash .\RemottoClientSetup.exe -Algorithm SHA256 | Format-List

Run the Installer

Run RemottoClientSetup.exe with administrator privileges. The following settings are configured automatically:

Specify the installation directory
Windows service (remotto-service) registration and auto-start
Firewall inbound rules (TCP/UDP)
Print monitoring event log channel activation
Server URL registry entry

⚠️ Note: You must specify the server address or domain during installation.
Example: 192.168.1.100, remotto.example.com

Verify Connection

After installation, the client PC automatically connects to the server. If the device appears in the “Device List” on the Admin Console, the setup is successful.

Mass Deployment (Silent Installation)

The installer supports silent mode. Use the /VERYSILENT option to install without GUI, and /SERVER= to specify the server address.

# Silent install (with server address)
RemottoClientSetup.exe /VERYSILENT /SERVER=192.168.1.100

# Domain name is also supported
RemottoClientSetup.exe /VERYSILENT /SERVER=remotto.example.com

Batch file example (deployment from shared folder):

@echo off
\\server\share\RemottoClientSetup.exe /VERYSILENT /SERVER=192.168.1.100

💡 Tip: Place the batch file in a shared folder and register it as a startup script through Active Directory Group Policy (GPO) for automated deployment to domain-joined PCs.

Reference

Required Ports

Port list for firewall and proxy configuration

Port List

Req.	Direction	Port	Protocol	Purpose
○	Server Inbound	`8080`	TCP	Admin Console & API
○	Server Inbound	`7880`	TCP	Signaling (WebSocket)
○	Server Inbound	`7882-7892`	UDP	Media Streaming (RTC)
○	Client Outbound	`3000`	TCP	Server API Connection
○	Client Outbound	`7880`	TCP	Signaling
△	Server / Client	`9`	UDP	WoL Magic Packet (when using WoL)
△	Server Outbound	`389` / `636`	TCP	LDAP / AD Authentication (when using LDAP)
△	Server Outbound	`25` / `465` / `587`	TCP	Print Quota Notification (when using email)
△	Client Local	`8888`	TCP	Web Filtering Proxy (when using Web Filter)

○ = Required　△ = Only when using the feature

Appendix

Uninstall

How to remove the server and client

Uninstall the Client

Remove via Windows “Apps & Features”

Open Windows Settings → “Apps” → “Installed apps”
Search for “Remotto Client” in the list
Click “Uninstall”

The uninstaller automatically handles:

Stopping and removing the Windows service (RemottoService)
Removing firewall rules
Removing registry keys
Removing program files

Silent Uninstall

You can also uninstall from the command line for mass removal.

# Run the uninstaller silently
“C:\Program Files\Remotto Client\unins000.exe” /VERYSILENT

ℹ️ Note:
• The configuration file (%PROGRAMDATA%\Remotto\server.conf) is preserved after uninstall. Delete it manually for a complete removal
• The device will remain as “Offline” in the admin console. Remove it from the console if no longer needed

Uninstall the Server

Windows

Same as the client — uninstall “Remotto Server” from “Apps & Features”.

⚠️ Note: PostgreSQL is installed separately and will not be removed by the server uninstaller.
To completely remove all data, uninstall PostgreSQL separately from “Apps & Features”.

Linux

Remove using your package manager.

# Ubuntu / Debian
sudo apt remove remotto-server

# Rocky Linux
sudo dnf remove remotto-server

ℹ️ Note:
• Configuration files (/etc/remotto/server.toml) and database are preserved
• For a complete removal, use apt purge / dnf remove and then manually delete the database