Skip to content

set_teleport_enabled

Toggle the Teleport VPN listener.

Side effects:

  • Patches the teleport setting record’s enabled field. When False, the controller tears down the listener and disconnects any active sessions. Registered clients (via the mobile app) remain registered and reconnect once the listener is re-enabled.
  • Mutates controller state. Use dry_run=True to preview.
set_teleport_enabled(enabled=True)
Parameter Type Required Default Description
enabled boolean yes True activates the listener; False disables it.
controller string no “default” Name of the UniFi controller to target. Defaults to "default".
dry_run boolean no false Preview the change without applying it.