Configuration

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

File location

  • Windows Windows: C:\Program Files\Reemo\service\reemo.ini

  • Linux Linux: /opt/reemo/reemo.ini

  • macOS 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

[auth]

token

The authentication token used to connect the agent to the Reemo portal. This token corresponds to your Personal Key (personal key) or Studio Key (organization key), depending on the chosen integration mode.

Type:

string

Default:

N/A

Required:

yes

Minimum version:

any version

[logger]

severity

The logging verbosity level.

Type:

integer (range 0–6)

Default:

0

Minimum version:

any version

[signal]

server

The signaling server address.

Type:

string

Default:

signal.reemo.io:443

Minimum version:

any version

[privacy]

autoon

Automatically enables privacy mode when connecting to the device (hides the screen from the local user).

Type:

boolean

Default:

false

Platform:

Windows Windows only

Minimum version:

Windows Windows 1.11.0.3

autolock

Automatically locks the device after disconnecting from a remote session.

Type:

boolean

Default:

false

Platform:

Windows Windows only

Minimum version:

Windows Windows 1.11.0.3

disablewallpaper

Hides the wallpaper during a remote session.

Type:

boolean

Default:

false

Platform:

Windows Windows only

Minimum version:

Windows Windows 1.18.0.2

[audio]

sync

Enables audio synchronization.

Type:

boolean

Default:

false

Minimum version:

Windows Windows 1.14.0.2, macOS macOS 1.4.1, Linux Linux 1.14.1

interval

Audio capture interval in milliseconds. Lower values increase crackling but reduce audio latency.

Type:

integer (20, 40 or 60)

Default:

60

Minimum version:

Windows Windows 1.14.0.2, macOS macOS 1.4.1, Linux Linux 1.14.1

[video]

constantfps

Do not sync with the screen vsync and attempt to reach the target framerate even with little desktop movement.

Type:

boolean

Default:

false

Platform:

Windows Windows only

Minimum version:

Windows Windows 1.18.0.2

[vmon]

hybrid

Disables physical monitors during the session to use only virtual displays. Physical monitors are restored only after disconnection.

Type:

boolean

Default:

false

Platform:

Windows Windows only

Minimum version:

Windows Windows 1.14.0.2

[printer]

enabled

Allows printing from the remote session to a local printer.

Type:

boolean

Default:

false

Platform:

Windows Windows and Linux Linux only

Minimum version:

Windows Windows 1.16.0.3, Linux Linux 1.17.6

[filetransfer]

enabled

Allows file transfer between the local and remote device.

Type:

boolean

Default:

false

Minimum version:

Windows Windows 1.19.0.2, macOS macOS 1.10.0, Linux Linux 1.19.0

destination

The default destination folder for transferred files. If not set, the user’s home directory will be used.

Type:

string

Default windows Windows :

C:\Users\<USERNAME>\Reemo\Transfer

Default linux Linux :

/home/<USERNAME>/Reemo/Transfer

Default macos macOS :

/Users/<USERNAME>/Reemo/Transfer

Minimum version:

Windows Windows 1.19.0.2, macOS macOS 1.10.0, Linux Linux 1.19.0

[support]

enabled

Enables support mode (required when using the Reemo Support application, allows your support team to access the device).

Type:

boolean

Default:

false

Platform:

Windows Windows and macOS macOS only

Minimum version:

Windows Windows 1.18.0.2, macOS macOS 1.9.0

[proxy]

enabled

Enables the HTTP proxy.

Type:

boolean

Default:

false

Minimum version:

Windows Windows 1.16.0.0, macOS macOS 1.6.0, Linux Linux 1.16.0

uri

The proxy server URI.

Type:

string

Default:

N/A

Required:

if the proxy is enabled

Minimum version:

Windows Windows 1.16.0.0, macOS macOS 1.6.0, Linux Linux 1.16.0

username

The username for proxy authentication.

Type:

string

Default:

N/A

Required:

if the proxy requires authentication

Minimum version:

Windows Windows 1.16.0.0, macOS macOS 1.6.0, Linux Linux 1.16.0

password

The password for proxy authentication.

Type:

string

Default:

N/A

Required:

if the proxy requires authentication

Minimum version:

Windows Windows 1.16.0.0, macOS macOS 1.6.0, Linux Linux 1.16.0

[udp]

portRangeBegin

The beginning of the UDP port range used for peer-to-peer connections.

Type:

integer (range 1024–65535)

Default:

58200

Minimum version:

any version

portRangeEnd

The end of the UDP port range used for peer-to-peer connections.

Type:

integer (range 1024–65535)

Default:

58400

Minimum version:

any version

[linux]

lowpower

This mode reduces the CPU usage of the Reemo Agent by limiting the frame capture rate to a lower value (15 fps).

Type:

boolean

Default:

false

Platform:

Linux Linux only

Minimum version:

Linux Linux 1.17.0

xdisplay

Specifies the X display to use for screen capture on Linux Linux devices. Useful when running the agent in a different session.

Type:

string

Default:

N/A

Platform:

Linux Linux only

Minimum version:

Linux Linux any version

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