Custom client advanced options

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`