Skip to content

Manage Instances

After creating an instance, you can manage it by navigating to the Instances tab in the left-hand navigation pane. Here you will see a list of created instances.

List of Nautobot Instances

Quick Actions

To manage a specific instance, click the ellipsis (...) button to the right of the instance you want to manage. This will open a dropdown menu with several options.

Dropdown to the right of an instance with a list of possible actions

The options include:

Action Description
Trends View usage and performance trends for the instance. See Monitoring Instances.
Event History Review a log of events and actions related to the instance. See Monitoring Instances.
Snapshots Manage snapshots for backup and recovery purposes. See Backup and Restore.
Edit Modify instance settings and configuration. You can change the instance name, description, and other fields. Find the full list of fields here. Fields that cannot be changed:
- Name (can only be set on creation)
- State (read-only)
Clone Create a new instance based on the current instance's configuration.
Update Apply updates to the instance software or configuration with a click.
Restart Restart the instance to resolve issues.
Recover Restore the instance from a snapshot or backup. See Backup and Restore.
Destroy ⚠ Permanently delete the instance and all associated data.

Instance Details

All instance types can be managed through a fullscreen detail view. For a detailed view of an instance, click on the instance name in the list. This will bring you to the instance detail view.

The detail view allows you to view and manage various aspects of the instance through several tabs:

Tabs

Edit the basic information about the instance which was set during creation. See Create an Instance for a full list of fields.

"Basic" tab of an instance detail view

View and edit non-sensitive environment variables for the instance. For sensitive configuration, consider using Secrets.

View a log of events and actions related to the instance. See Monitoring Instances.

"Event History" tab of an instance detail view

View and manage secrets associated with the instance. See Managing Secrets.

"Secrets" tab of an instance detail view

To associate an existing secret with the instance, click the Associate button in the top-right corner. This will bring up a dialog where you can select a secret to associate with the instance. If you have not yet created a secret, see Manage Secrets for instructions.

"Associate Secret" dialog

See Quick Actions for more information.

Additional Tabs for Nautobot Instances

When viewing a Nautobot instance, you will see several additional tabs not available for other instance types. Use these tabs to perform common Nautobot management tasks directly from the instance detail view.

View and manage apps installed on the Nautobot instance. Here you can install, reconfigure, or remove apps from the instance.

"Apps" tab of a Nautobot instance detail view

To install a new app, click the Install Apps button in the top-right corner. This will bring up a dialog where you can select the apps you want to install from the Nautobot Cloud Marketplace.

"Install Apps" dialog

Note that some apps may require additional configuration after installation. You can do this by clicking the name of the app in the list. This opens up a dialog where you can configure the app's settings.

"App Configuration" sub-dialog in the "Install Apps" dialog

For apps that require additional configuration, you will see a warning icon next to the app name in the list. You must configure the app before it can be used.

View usage, size, and performance trends for the instance. See Monitoring Instances.

"Trends" tab of a Nautobot instance detail view

View and manage snapshots for the instance, or revert to a previous version. See Backup and Restore.

"Snapshots" tab of a Nautobot instance detail view