Custom client advanced options

Prev Next
This content is currently unavailable in Ja - 日本語. You are viewing the default (English) version.

Platform: Windows only

Other than the regular customization options, AnyDesk offers Advanced options to help users fine-tune their AnyDesk clients to their exact specifications.

You can either override a setting (meaning there is no way to change it back within AnyDesk) or change the default setting which AnyDesk uses. For security-related features, we recommend using “Override settings” so that they cannot be changed from the user interface of the custom client.

Tip: Value possibilities in bold are the default options.


Client features

Feature

Key-value pair

Value possibilities

Use specific version

_module=anydesk-<version>

Example: _module=anydesk-6.0.8

Automatically register Alias

ad.features.register_alias=true

false, true

Auto register Alias to custom namespace

⚠️ For custom Windows MSI installers, do not enable this in the client configurator (Hostname as Alias in my.anydesk II). This is applicable only for the Cloud solution; it is not needed for On-Premises clients.

ad.anynet.register.add_to_namespace=true

false, true

Request elevation on startup (UAC)

ad.features.auto_uac=true

false, true

Allow installation

ad.features.install=true

false, true

Prevent users from removing the license

ad.license.permissions=0

0: No permission

1: Has permission

Disable Screen Recording feature (AnyDesk 9.0.0+)

ad.features.screen_recording=false

false, true

Enable AnyDesk Assist feature (Ultimate-Cloud only, AnyDesk 9.0.0+)

ad.session_queue.init=1

0: Disable

1: Enable

Enable Request Support feature (Ultimate-Cloud only, AnyDesk 9.0.0+)

ad.session_queue.help_button=1

0: Disable

1: Enable

Disable Chat feature (AnyDesk 9.0.7+ for Windows)

ad.features.session.chat=false

false, true


Client settings

Feature

Key-value pair

Value possibilities

Disable all settings

ad.ui/cfg_enables=false

false , true


User interface settings

Feature

Key-value pair

Value possibilities

Disable User Interface settings

ad.ui.cfg_enable_interface=false

false , true

Set default language

ad.ui.lang=<language>

See Language codes.

Disable auto-select language

ad.ui.lang.auto=false

false , true

Disable invitation email option

ad.ui.show_invite=false

false , true

Disable sending of direct invitations

ad.features.session_invitation.send=false

false , true

Disable receiving of direct invitations

ad.features.session_invitation.receive=false

false , true

Show AnyDesk ID instead of Alias (AnyDesk 6 or older)

ad.ui.alias_or_id=true

false , true

Hide the AnyDesk ID and Alias

ad.ui.hide_ad_id=1

0: Disable

1: Enable

Hide local taskbar when AnyDesk window is maximized

ad.ui.maximize_type=true

false , true

Disable comment prompt on session close

ad.ui.comment_session=false

false , true

Start AnyDesk in advanced view (AnyDesk 4 or older)

ad.roster.adv_view=true

false , true

Remove the "What’s New" tile

ad.ui.show_tile.whats_new=0

0: Disable

1: Enable

Remove the AnyDesk Status tile

ad.ui.show_tile.anydesk_status=false

false , true

Remove the Installation tile

ad.ui.show_tile.install_anydesk=false

false , true

Remove "Set password for unattended access" tile (Pre-AnyDesk 7)

ad.ui.show_tile.password=0

0: Disable

1: Enable

Remove Discovery feature tile

ad.discovery.show_tile=0

0: Disable

1: Enable

Remove Telemetry Consent tile

ad.ui.show_tile.telemetry=0

0: Disable

1: Enable

Disable Recent Sessions

ad.features.recent_out=0

0: Disable

1: Enable

Disable Favorites

ad.features.favorites=0

0: Disable

1: Enable

Remove Retry Connection button

ad.ui.show_retry_button=0

0: Disable

1: Enable

Hide pie menu button on inactivity (Android only)

ad.ui.auto_hide_nubsi=true

false , true

Hide plugin installation dialog (Android only)

ad.ui.enable.dialog.plugin.install=0

0: Disable

1: Enable

Hide plugin update dialog (Android only)

ad.ui.enable.dialog.plugin.update=0

0: Disable

1: Enable

Hide plugin activation dialog (Android only)

ad.ui.enable.dialog.plugin.activation=0

0: Disable

1: Enable

Hide battery optimization dialog (Android only)

ad.ui.enable.dialog.battery_optimization=0

0: Disable

1: Enable

Hide overlay permission dialog (Android only)

ad.ui.enable.dialog.overlay_permission=0

0: Disable

1: Enable

Hide scam warning dialog (Android only)

ad.ui.enable.dialog.local_scam_warning=0

0: Disable

1: Enable

Disable automatic tutorial start (Android only)

ad.ui.enable.tutorial_autostart=0

0: Disable

1: Enable

Hide privacy policy dialog (Android only)

ad.ui.enable.dialog.privacy_policy=0

0: Disable

1: Enable

Hide setup reminder dialog (Android only)

ad.ui.enable.dialog.setup_prompt=0

0: Disable

1: Enable


Security settings

Feature

Key-value pair

Value possibilities

Disable Security settings

ad.ui.cfg_enable_security=false

false, true

Disable Access settings

ad.ui.cfg_enable_access=false

false, true

Disable Permissions settings

ad.ui.cfg_enable_permission_profiles=false

false, true

Disable interactive access

⚠️ By default, if AnyDesk is installed, the Accept Window always appears. When uninstalled, it appears only if an AnyDesk window is open.

ad.security.interactive_access=2

2: disable,

1: enable when AnyDesk is open,

0: always enabled

Enable Access Control List

ad.security.acl_enabled=true

false, true

Disable unattended access

ad.features.unattended=false

false

Forbid others to save login information for this computer

ad.security.allow_logon_token=false

false, true

Disable Two-Factor-Authentication

ad.features.two_factor_auth=false

false, true

Disable File Manager sessions

ad.features.file_manager=false

false, true

Show list of logged in users (Windows Server only)

ad.security.connect.send_user_list=1

0: Disable,

1: Enable

Disable clipboard sync, even with remote endpoint permission.

ad.security.frontend_clipboard=0

0: Disable,

1: Enable

Disable clipboard files sync, even with remote endpoint permission.

ad.security.frontend_clipboard_files=0

0: Disable,

1: Enable

Disable lock account on session end even with remote endpoint permission

ad.security.sess.lock_remote_account=0

0: Disable,

1: Enable

Terminate existing incoming sessions when receiving a session request (Android only)

ad.security.kickout=1

0: Disable,

1: Enable

Protect settings with device or biometric credentials (Android only)

ad.security.settings_protection=2

0: Disable,

2: Enable

Permission Profiles (AnyDesk 7+)

Tip: Use the Permission Profile Key-Value Pair Generator to generate the key-value pairs needed for your custom configuration.

Warning: Permission profile key-value pairs introduced in AnyDesk 7 provide more flexibility than the previous ad.security key-value pairs.

You can define up to 10 custom profiles, each with unique permissions and optional unattended access passwords. These profiles allow finer control by separating permissions for:

  • The Accept Window

  • Settings > Access

Example

To disable audio transmission by default when profile1 is selected, use:

ad.security.permission_profiles.profile1.permissions.audio=0

The remote user can still re-enable the permission via the Accept Window. To prevent this:

ad.security.permission_profiles.profile1.changeable_in_accept_window.audio=0

Feature

Key-value pair

Values

Profile identifiers

<profile_id>

Default: default, full_access, screensharing, unattendedaccessCustom: profile1 to profile10

Permissions list

<permission>

audio, input, clipboard, clipboard_files, block_input, sas, restart, file_manager, lock_desk, sysinfo, whiteboard, tcp_tunnel, vpn, user_pointer, privacy_feature, record_session, logoff_session

Enable session profile memory

ad.security.permission_profiles.enable_previous_session

0 = No, 1 = Yes

Define profile name

ad.security.permission_profiles.define.<profile_id>=<name>

Example: ad.security.permission_profiles.define.profile1=myprofile

Disable permission in Settings

ad.security.permission_profiles.<profile_id>.permissions.<permission>=0

0 = Disabled, 1 = Enabled

Disable permission change via Accept Window

ad.security.permission_profiles.<profile_id>.changeable_in_accept_window.<permission>=0

0 = Not changeable, 1 = Changeable

Allow profile switching

ad.security.permission_profiles.<profile_id>.can_switch_profile

0 = No, 1 = Yes

Show profile in Accept Window

ad.security.permission_profiles.<profile_id>.show_in_accept_window

0 = No, 1 = Yes

Set unattended access password

ad.security.permission_profiles.<profile_id>.pwd=<hash>ad.security.permission_profiles.<profile_id>.salt=<salt>

Leave empty to disable. Hash and salt can be generated with the Password Generator.

Remove profile from custom client

ad.security.permission_profiles.<profile_id>.removed=1

Allow manual profile creation

ad.security.permission_profiles.can_create=1

0 = No, 1 = Yes

Global permissions (Settings)

ad.security.permission_profiles.permissions.<permission>

0 = Disabled, 1 = Enabled

Global permissions (Accept Window)

ad.security.permission_profiles.changeable_in_accept_window.<permission>

0 = Not changeable, 1 = Changeable

Global profile switching

ad.security.permission_profiles.can_switch_profile

0 = No, 1 = Yes

Global profile visibility in Accept Window

ad.security.permission_profiles.show_in_accept_window

0 = No, 1 = Yes

Unattended Access settings (AnyDesk 7 and older)

Warning: In AnyDesk 7 and later, the key-value pairs listed here only apply to the Unattended Access profile if it has been explicitly configured within the custom client.

These settings define the permissions available during unattended access sessions. They only take effect if ad.security.enable_uaccess_permissions=true is set and different permissions for unattended access are configured.

Enable unattended access-specific permissions

Feature

Key-value pair

Values

Override standard permissions for unattended access

ad.security.enable_uaccess_permissions

true (enable), false (disable)

Permission controls for unattended access

Action

Key-value pair

Values

Allow hearing computer’s audio

ad.security.uaccess.hear_audio

true, false

Allow control of keyboard and mouse

ad.security.uaccess.control_input

true, false

Allow access to clipboard content

ad.security.uaccess.sync_clipbrd

true, false

Allow file transfers via clipboard

ad.security.uaccess.clipboard.files

true, false

Allow keyboard and mouse to be locked

ad.security.uaccess.block_input

true, false

Allow system restart

ad.security.uaccess.restart

true, false

Allow use of file manager

ad.security.uaccess.file_manager

true, false

Lock desktop after session ends

ad.security.uaccess.lock_account

true, false

Allow system information request

ad.security.uaccess.sysinfo

true, false

Allow remote printing

ad.security.uaccess.print

true, false

Allow screen annotations (whiteboard)

ad.security.uaccess.whiteboard

true, false

Allow TCP tunnel creation

ad.security.uaccess.tcp_tunnel

true, false

Enable privacy mode

ad.security.uaccess.privacy_feature

true, false

Show a colored pointer during blocked input

ad.security.uaccess.user_pointer

true, false

Interactive Access / Accept window settings (AnyDesk 7 and older)

These key-value pairs control permissions during interactive sessions for versions prior to AnyDesk 7. Use them to restrict what remote users can do during a session initiated via the Accept Window.

Action

Key-value pair

Values

Allow hearing computer’s audio

ad.security.hear_audio

true, false

Allow control of keyboard and mouse

ad.security.control_input

true, false

Allow access to clipboard content

ad.security.sync_clipbrd

true, false

Allow file transfers via clipboard

ad.security.clipboard.files

true, false

Allow keyboard and mouse to be locked

ad.security.block_input

true, false

Allow system restart

ad.security.restart

true, false

Allow use of file manager

ad.security.file_manager

true, false

Allow system information request

ad.security.sysinfo

true, false

Allow remote printing

ad.security.print

true, false

Allow screen annotations (whiteboard)

ad.security.whiteboard

true, false

Allow TCP tunnel creation

ad.security.tcp_tunnel

true, false

Enable privacy mode

ad.security.privacy_feature

true, false

Show colored pointer during blocked input

ad.security.user_pointer

true, false

Discovery settings

These key-value pairs control how the Discovery feature behaves in AnyDesk, including network visibility, multicast communication, and participation settings.

Configuration options

Feature

Key-value pair

Value options

Disable the Discovery feature entirely

ad.features.discovery

true, false

Disable scanning the local network for other clients

ad.discovery.default_behavior=0

ad.discovery.enabled=false

0: Disabled

1: Enabled

false, true

Exclude this device from being discoverable

ad.discovery.hidden

true, false

Set the IP address used for multicast communication

ad.discovery.multicast_ip

e.g. 239.255.102.18

Set the port used for multicast communication

ad.discovery.multicast_port

e.g. 50001

Define the number of UDP ports to use, starting from ad.discovery.multicast_port

ad.discovery.port_range

e.g. 1, 2, 3

Auto-disconnect settings

These key-value pairs control the automatic disconnection behavior for inactive remote sessions in AnyDesk.

Feature

Key-value pair

Value options

Enable or disable auto-disconnect

ad.security.auto_disconnect.mode

0: Disabled1: Enabled

Set timeout duration before auto-disconnect (in seconds)

ad.security.auto_disconnect.timeout

Minimum: 60


Privacy settings

These key‑value pairs control display and privacy features in AnyDesk, including visible identity, background previews, chat logs, and screen framing.

Feature

Key‑value pair

Options

Enable or disable privacy settings

ad.ui.cfg_enable_privacy

false or true

Choose displayed username

ad.privacy.name.show

1 = Account username2 = Custom username

Enter custom username (when using custom type)

ad.privacy.name

Example: user1

Choose displayed user image

ad.privacy.image.show

0 = Hide image1 = Show account image

Select background in desk preview

ad.privacy.bkgnd.show

0 = Screenshot1 = Wallpaper3 = Disabled

Choose screenshot path option

ad.privacy.scrshot.path_cfg

1 = Default2 = Custom

Set a custom screenshot path

ad.privacy.scrshot.path

Example: C:\Users\<username>\...

Choose chat log storage location

ad.privacy.chat.path_cfg

0 = Disabled1 = Default path2 = Custom path

Set a custom chat log path

ad.privacy.chat.path

Example: C:\Users\<username>\...

Enable alternative screen background (ASB) color

ad.privacy.wallpaper.mode

0 = Disabled1 = Color

Set ASB color

ad.privacy.wallpaper.color

Default: #000000FF

Enable screen frame overlay

ad.privacy.screen_frame.mode

0 = Disabled1 = Enabled

Set screen frame width (pixels)

ad.privacy.screen_frame.width

Range: 5–20; default: 10

Set screen frame opacity (alpha)

ad.privacy.screen_frame.opacity

Range: 51–255; default: 128

Set screen frame color (RGBA hex)

ad.privacy.screen_frame.color

Default: #FF0000FF

Display settings

These key-value pairs control how visual elements are rendered in AnyDesk, including video quality, cursor visibility, screen mode, rendering methods, and session behavior.

Feature

Key‑value pair

Options

Enable or disable display settings

ad.ui.cfg_enable_video

false, true

Set display quality preference

ad.image.quality_preset

0 = Best quality1 = Balanced2 = Optimize response time

Choose remote cursor behavior

ad.image.show_remote_cursor_option

0 = Hide cursor1 = Show cursor always2 = Show cursor only on movement

Show move/resize helper overlay

ad.image.move_size_hlp

false, true

Prevent hotkey transmission to the remote device

ad.image.suppress_keys

false, true

Choose view mode scaling

ad.image.viewmode

0 = Original size1 = Shrink2 = Stretch

Start new sessions in fullscreen

ad.image.insta_fullscreen

false, true

Enable edge scrolling in original view mode

ad.image.edge_scroll

false, true

Select full-screen mode behavior

ad.image.fullscreen_mode

0 = Exclusive1 = Windowed

Choose rendering method

ad.image.rendermode

0 = Disabled1 = DirectDraw2 = Direct3D3 = OpenGL

Disable saving display settings between sessions

ad.session.remember_settings

false, true

Audio settings

Use the following key-value pairs to configure audio behavior for AnyDesk sessions, including transmission and playback modes.

Feature

Key‑value pair

Options

Enable or disable audio settings

ad.ui.cfg_enable_audio

false, true

Set audio transmission mode

ad.audio.transmit_mode

0 = Disabled1 = Standard2 = Transmit audio output3 = Specify manually

Set audio playback mode

ad.audio.playback_mode

0 = Disabled1 = Standard3 = Specify manually

Enable exclusive audio playback

ad.audio.exclusive

false, true

Connection settings

Use the following key-value pairs to configure network connection parameters, including direct connection behavior, session limits, and proxy settings.

Feature

Key‑value pair

Options

Enable or disable connection settings

ad.ui.cfg_enable_connection

false, true

Disable direct connections

ad.anynet.direct

false, true

Set the listening port

ad.anynet.listen_port=<port>

Default: 7070

Limit incoming sessions

ad.session.limit_incoming=<number>

Example: 1, 2, 3, ...

Limit outgoing sessions

ad.session.limit_outgoing=<number>

Example: 1, 2, 3, ...

HTTP-Proxy settings

Proxy key-value pairs set in the "Overwrite settings" section do not disable access to proxy configuration in the UI. Users can still adjust these settings if they have access to the Connection tab.

Feature

Key‑value pair

Options

Force use of proxy

ad.anynet.proxy.mandatory

false, true

Set proxy mode

ad.anynet.proxy.mode

0 = Never use a proxy1 = Auto-detect2 = Use a specific proxy

Set proxy type

ad.anynet.proxy.type

0 = HTTP1 = SOCKS

Ask for proxy authentication

ad.anynet.proxy.auth

false, true

Automatically detect proxy authentication

ad.anynet.proxy.auto_auth

false, true

NTLM authentication configuration:

ad.anynet.proxy.mandatory=true
ad.anynet.proxy.auth=false
ad.anynet.proxy.auto_auth=true

File Transfer settings

Feature

Key‑value pair

Options

Enable or disable File Transfer settings

ad.ui.cfg_enable_filetransfer

false, true

  • false: Disables the File Transfer section in the AnyDesk client settings.

  • true: Enables access to file transfer settings.

Recording settings

Feature

Key‑value pair

Options

Disable session recording feature

ad.features.sess_record

false, true

Disable access to session recording settings

ad.ui.cfg_enable_recording

false, true

Disable session playback

ad.features.sess_playback

false, true

Automatic recording settings

Description

Key‑value pair

Options

Start recording for all sessions (non-Windows and Windows < 6.1.0)

ad.recording.auto_start

false, true

Start recording when an incoming session starts and the user is logged out (Windows ≥ 6.1.0)

ad.recording.auto_start.incoming.admin

0: Disabled, 1: Enabled

Start recording when an incoming session starts and the user is logged in (Windows ≥ 6.1.0)

ad.recording.auto_start.incoming

0: Disabled, 1: Enabled

Start recording for outgoing sessions (Windows ≥ 6.1.0)

ad.recording.auto_start.outgoing

0: Disabled, 1: Enabled

Other settings

Description

Key‑value pair

Options

Prevent remote users from recording the session

ad.security.record_session

false, true

Set session recording path configuration

ad.recording.path_cfg

1: Default path, 2: Custom path

Specify custom recording path

ad.recording.path

e.g., C:\Recordings

VPN settings

Feature

Key‑value pair

Options

Disable the VPN feature

ad.features.vpn

false, true

Disable access to VPN settings

ad.ui.cfg_enable_vpn

false, true

Wake-on-LAN settings

Feature

Key‑value pair

Options

Disable the Wake-on-LAN feature

ad.features.wol

false, true

Disable access to Wake-on-LAN settings

ad.ui.cfg_enable_wol

false, true

Window positions and size (AnyDesk 7 and older)

Feature

Key‑value pair

Options

Start AnyDesk in a maximized window

ad.ui.main_win.max

false, true

Set the horizontal position of the left window border

ad.ui.main_win.x

Value in pixels, e.g. 100

Set the vertical position of the top window border

ad.ui.main_win.y

Value in pixels, e.g. 100

Set the window width

ad.ui.main_win.width

Minimum: 900, e.g. 1000

Set the window height

ad.ui.main_win.height

Minimum: 720, e.g. 1000

Disclaimer settings

Feature

Key‑value pair

Options

Set the disclaimer title

ad.ui.disclaimer.title=<text>

Replace <text> with your custom title

Set the disclaimer body text

ad.ui.disclaimer.text=<text>

Replace <text> with your custom message

Set the text for the accept button

ad.ui.disclaimer.accept=<text>

Replace <text> with button label

Set the text for the cancel button

ad.ui.disclaimer.cancel=<text>

Replace <text> with button label

Set the text and title color

ad.ui.disclaimer.text.color=<HTML color code>

e.g. #FFFFFF

Set the background color

ad.ui.disclaimer.bg.color=<HTML color code>

e.g. #FFFFFF

Display a session disclaimer for interactive access

ad.session_warning.show=1

0: No, 1: Yes

Require a 10-second delay before the disclaimer can be accepted

ad.session_warning.timeout_mode=1

0: No, 1: Yes

Set the session disclaimer message

ad.session_warning.msg=<text>

Replace <text> with your custom message


Layout settings (AnyDesk 6 and older)

Feature

Key-value pair

Value possibilities

Change the label for "This Desk"

ad.ui.id_group.title=<text>

<text>: Custom label text

Replace the description under "This Desk"

ad.ui.id_group.text=<text>

<text>: Custom description text

Change the label for "Remote Desk"

ad.ui.connect_group.title=<text>

<text>: Custom label text

Replace the description under "Remote Desk"

ad.ui.connect_group.text=<text>

<text>: Custom description text


Address book

Feature

Key-value pair

Value possibilities

Disable Address Book

ad.features.address_book=false

false , true

Choose Address Book view type

ad.abook.view_type=0

0: Default

1: List

2: Big Tiles

4: Small Tiles

Automatically tag entries added via “Add to Address Book” option

ad.anynet.register.roster_tags=<text>

<text>: Custom tag(s) to be applied automatically


Language codes

Language

ISO code

Bulgarian

bg

Croatian

hr

Czech

cz

Danish

da

Dutch

nl

English

en

Estonian

et

Finnish

di

French

fr

German

de

Greek

el

Hungarian

hu

Italian

it

Japanese

ja

Korean

ko

Norwegian

no

Polish

pl

Portuguese

pt

Portuguese (Brazil)

pt-br

Romanian

ro

Russian

ru

Simplified Chinese

zh

Slovak

sk

Spanish

es

Swedish

sv

Traditional Chinese

zh-cl

Turkish

tr

Ukrainian

uk