Configuration¶

The configuration of the Reemo Agent is done through the reemo.ini file.

File location¶

Windows: C:\Program Files\Reemo\service\reemo.ini
Linux: /opt/reemo/reemo.ini
macOS: /Library/Application Support/Reemo/reemo.ini

Minimal configuration¶

Here is the minimal configuration created after installation:

[auth]
token=<PRIVATE_KEY>

With a custom signaling server:

[auth]
token=<PRIVATE_KEY>

[signal]
server=<SIGNAL_SERVER> # Often <CLIENT_NAME>-signal.cloud.reemo.io:8443

Available options¶

Note

After any modification of the reemo.ini file, it is necessary to restart the Reemo agent for the new settings to take effect.

[auth]¶

Option	Description	Type	Default	Minimum version
`token`	The authentication token used to connect the agent to the Reemo portal. This token corresponds to your Personal Key or Studio Key (organization key), depending on the chosen integration mode. Required.	string	`N/A`	any version

Example:

[auth]
token=<PRIVATE_KEY>

[logger]¶

Option	Description	Type	Default	Minimum version
`severity`	The logging verbosity level.	integer (range 0–6)	`0`	any version

Example:

[logger]
severity=3

[signal]¶

Option	Description	Type	Default	Minimum version
`server`	The signaling server address.	string	`signal.reemo.io:443`	any version

Example:

[signal]
server=<SIGNAL_SERVER> # Often <CLIENT_NAME>-signal.cloud.reemo.io:8443

[privacy]¶

Option	Description	Type	Default	Minimum version
`autoon`	Automatically enables privacy mode when connecting to the device (hides the screen from the local user).	boolean	`false`	`1.11.0.3` `2.5.1`
`autolock`	Automatically locks the device after disconnecting from a remote session.	boolean	`false`	`1.11.0.3` `2.5.1` `2.6.0`
`disablewallpaper`	Hides the wallpaper during a remote session.	boolean	`false`	`1.18.0.2`

Example:

[privacy]
autoon=true
autolock=true
disablewallpaper=true

[audio]¶

Option	Description	Type	Default	Minimum version
`sync`	Enables audio synchronization.	boolean	`false`	`1.14.0.2` `1.4.1` `1.14.1`
`interval`	Audio capture interval in milliseconds. Lower values increase crackling but reduce audio latency.	integer (10, 20, 40, or 60)	`20`	`2.3.0.0` `2.4.0` `2.5.0`

Example:

[audio]
sync=true
interval=20

[video]¶

Option	Description	Type	Default	Minimum version
`constantfps`	Do not sync with the screen vsync and attempt to reach the target framerate even with little desktop movement.	boolean	`false`	`1.18.0.2`

Example:

[video]
constantfps=true

[vmon]¶

Option	Description	Type	Default	Minimum version
`hybrid`	Disables physical monitors during the session to use only virtual displays. Physical monitors are restored only after disconnection.	boolean	`false`	`1.14.0.2` `2.5.1`

Example:

[vmon]
hybrid=true

[printer]¶

Option	Description	Type	Default	Minimum version
`enabled`	Allows printing from the remote session to a local printer.	boolean	`false`	`1.16.0.3` `1.17.6`

Example:

[printer]
enabled=true

[filetransfer]¶

Option	Description	Type	Default	Minimum version
`enabled`	Allows file transfer between the local and remote device.	boolean	`false`	`1.19.0.2` `1.10.0` `1.19.0`
`destination`	The default destination folder for transferred files. If not set, the user’s home directory will be used.	string	`C:\Users\<USERNAME>\Reemo\Transfer` `/home/<USERNAME>/Reemo/Transfer` `/Users/<USERNAME>/Reemo/Transfer`	`1.19.0.2` `1.10.0` `1.19.0`

Example:

[filetransfer]
enabled=true
destination=/home/<USERNAME>/Reemo/Transfer

[support]¶

Option	Description	Type	Default	Minimum version
`enabled`	Enables support mode (required when using the Reemo Support application, allows your support team to access the device). See Reemo Support for the full workflow.	boolean	`false`	`1.18.0.2` `1.9.0`

Example:

[support]
enabled=true

[proxy]¶

Configure outbound HTTP proxy access to the internet.

Option	Description	Type	Default	Minimum version
`enabled`	Enables the HTTP proxy.	boolean	`false`	`1.16.0.0` `1.6.0` `1.16.0`
`uri`	The proxy server URI. Required if the proxy is enabled.	string	`N/A`	`1.16.0.0` `1.6.0` `1.16.0`
`username`	The username for proxy authentication. Required if the proxy requires authentication.	string	`N/A`	`1.16.0.0` `1.6.0` `1.16.0`
`password`	The password for proxy authentication. Required if the proxy requires authentication.	string	`N/A`	`1.16.0.0` `1.6.0` `1.16.0`

Example:

[proxy]
enabled=true
uri=http://proxy.example.com:8080
username=proxyuser
password=<PROXY_PASSWORD>

[udp]¶

Option	Description	Type	Default	Minimum version
`portRangeBegin`	The beginning of the UDP port range used for peer-to-peer connections.	integer (range 1024–65535)	`58200`	any version
`portRangeEnd`	The end of the UDP port range used for peer-to-peer connections.	integer (range 1024–65535)	`58400`	any version

Example:

[udp]
portRangeBegin=58200
portRangeEnd=58400

[windows]¶

Option	Description	Type	Default	Minimum version
`mousekeys`	Determines whether the application automatically enables Windows Mouse Keys to ensure cursor visibility.	boolean	`true`	`2.0.0.3`

On Windows host machines without a physical mouse connected, the cursor may disappear by default. When this setting is true, the application forces Mouse Keys “on” to prevent this behavior. If set to false, the application will no longer manage this accessibility feature, leaving the current system state untouched.

Example:

[windows]
mousekeys=false

[linux]¶

Option	Description	Type	Default	Minimum version
`lowpower`	This mode reduces the CPU usage of the Reemo Agent by limiting the frame capture rate to a lower value (15 fps).	boolean	`false`	`1.17.0`
`xdisplay`	Specifies the X display to use for screen capture on Linux devices. Useful when running the agent in a different session.	string	`N/A`	any version

Example:

[linux]
lowpower=true
xdisplay=:1