Skip to main content

Connectivity Management and Route Configuration

Set the maximum number of hops allowed per route

Key<add key="MaxHopsForRoute" value="10"/>
Possible valuesNumeric
Where to add/changecustomer.config CloudShell Server installation directory
Default value6
Affected CloudShell ComponentCloudShell Portal
Version6.0 and above

Enable automatic route configuration (automatically configures L1 connections)

Key<add key="EnableRouteConfiguration" value="True"/>
Possible valuesTrue/False
Where to add/changecustomer.config CloudShell Server installation directory
Default valueFalse
Affected CloudShell ComponentCloudShell Portal
Version6.0 and above

Select the network route resolution strategy

By default, CloudShell resolves network routes under a single, server-wide lock, so concurrent route resolutions run one at a time. Setting this key to Optimistic enables an opt-in resolver that performs the route-resolution work outside that global lock and commits the result using optimistic concurrency (it validates and, if another reservation claimed a needed resource in the meantime, retries). This allows multiple route resolutions to proceed in parallel, which can increase route-resolution throughput when many reservations resolve routes at the same time. The default Legacy strategy preserves the original single-lock behavior. Any unrecognized value falls back to Legacy.

Changing this key requires a restart of the CloudShell Server.

Key<add key="NetworkRouteResolverStrategy" value="Optimistic"/>
Possible valuesLegacy/Optimistic
Where to add/changecustomer.config CloudShell Server installation directory
Default valueLegacy
Affected CloudShell ComponentCloudShell Server
Version2026.1 and above

Enable regular users to change their email address

Key<add key="ChangeEmailEnabled" value="True"/>
Possible valuesTrue/False
Where to add/changecustomer.config CloudShell Portal installation directory
Default valueFalse
Affected CloudShell ComponentCloudShell Portal
Version7.0 and above

Enable regular users to change email notifications

Key<add key="ReservationEmail.NonAdminCanChangeNotifications" value="False"/>
Possible valuesTrue/False
Where to add/changecustomer.config CloudShell Server installation directory
Default valueTrue
Affected CloudShell ComponentCloudShell Portal
Version6.0 and above

Set the default number of max hops displayed for routes (in the connection’s Max Hops field in the Resource Connections dialog box)

Key<add key="DefaultMaxHopsForRoute" value="2"/>
Possible valuesNumeric (in hops)
Where to add/changecustomer.config CloudShell Server installation directory
Default value2
Affected CloudShell ComponentCloudShell Portal
Version6.1 and above

Set the default connection type when creating a connection

Key<add key="DefaultSelectedConnectionType" value=""/>
Possible valuesText
Where to add/changecustomer.config CloudShell Server installation directory
Default valueRoute
Affected CloudShell ComponentCloudShell Portal
Version6.2 and above

Set the supported connection types for new connections

Key<add key="SupportedConnectionTypes" value=""/>
Possible valuesConnection type, separated by comma
Where to add/changecustomer.config CloudShell Portal installation directory
Default valueRoute, Cable, Tap, Connector
Affected CloudShell ComponentCloudShell Portal
Version6.2 and above