Add a deployment

In Instances, navigate to Self-managed and use the Add deployment button to get started.

new self managed
Figure 1. Add a new self-managed deployment

Then you need to decide what type of connection you want to create to the self-managed instance.

The wizard provides two top-level options.

  • Monitored - this option allows you to set up Fleet Manager.

  • Unmonitored - this option allows you to add an unmonitored deployment that can still be connected to using the provided connection URL.

add sm deployment
Figure 2. Add a self-managed deployment

Set up a connection without monitoring

To set up a connection without monitoring, select the Unmonitored option, provide the connection URL to your deployment, your credentials, and click Connect. Then, click Add to add your deployment to Aura. Adding your self-managed deployment to Aura allows you to use the graph tools Query, Explore, and Dashboards to run queries, explore the graph, and create dashboards. See Self-managed instances for more information.

Set up a connection with monitoring

In versions 2026.03 and later, Fleet Manager is enabled by default, so you can add a deployment from the wizard and start monitoring it without any additional setup.

In earlier versions, it is available as a plugin that you can install in your self-managed deployment. These includes versions Neo4j 4.4.45+, 5.26.12+, and versions between 2025.08.0 and 2026.02.2 inclusive.

Set up a connection with monitoring in versions 2026.03 and later

To set up a connection with monitoring, select the Monitored option and click the Connect…​ button to connect to your instance. In the dialog that appears, input the URL and credentials to your deployment and connect.

connectionmodalnonremote
Figure 3. Connect to your deployment

After connecting, Aura runs the fleetManagement.registerToken() procedure to check whether your deployment meets the requirements for Fleet Manager.

fm connectionsuccess
Figure 4. Ready for Fleet Manager

If the check is successful, you will see a success message and can select Next to have Aura automatically generate and add an access token to your deployment.

Set up a connection with monitoring in versions before 2026.03

In versions Neo4j 4.4.45+, 5.26.12+, and versions between 2025.08.0 and 2026.02.2 inclusive, Fleet Manager is available as a plugin that you need to install in your self-managed deployment.

  1. Install the Fleet management plugin following the instructions on the wizard or, alternatively, see Operations Manual → Install and configure plugins.

  2. In Neo4j Browser or any other Neo4j client, run the procedure CALL fleetManagement.status() to check if the plugin is installed and working correctly. If the procedure returns a result, the plugin is installed.

  3. Click Next.

  4. On the Request token page, select the desired expiry time for the token and whether to enable auto-rotation. If auto-rotation is enabled, the plugin automatically negotiates a new token before the current one expires.

  5. On the Register token page, you will see the generated token.

    1. Save it in a secure location.

    2. Register your saved token using the procedure fleetManagement.registerToken(), as described in the wizard. If your deployment is a cluster, the token must be registered only once to take effect across all servers.

      Registering a token associates the deployment with the Aura project used to generate the token. Never register a token obtained from a third party.