influxdb3 stop node
The influxdb3 stop node command marks a node as stopped in the catalog, freeing up the licensed cores it was using for other nodes.
This command is designed for cleaning up the catalog after you have already stopped the physical instance.
It does not shut down the running process - you must stop the instance first (for example, using kill or stopping the container).
Usage
influxdb3 stop node [OPTIONS] --node-id <NODE_ID>Options
| Option | Description | |
|---|---|---|
--node-id | (Required) The node ID to stop | |
--force | Skip confirmation prompt | |
-H | --host | Host URL of the running InfluxDB 3 Enterprise server (default is http://127.0.0.1:8181) |
--token | Authentication token | |
--tls-ca | Path to a custom TLS certificate authority (for testing or self-signed certificates) | |
-h | --help | Print help information |
Option environment variables
You can use the following environment variables to set command options:
| Environment Variable | Option |
|---|---|
INFLUXDB3_HOST_URL | --host |
INFLUXDB3_AUTH_TOKEN | --token |
Use case
Use this command when you have forcefully stopped a node instance (for example, using kill -9 or stopping a container) and need to update the catalog to reflect the change.
This frees up the licensed cores from the stopped node so other nodes can use them.
Behavior
When you run this command:
- The command marks the specified node as
stoppedin the catalog - Licensed cores from the stopped node are freed for reuse by other nodes
- Other nodes in the cluster see the update after their catalog sync interval (default 10 seconds)
- The command requires authentication if the server has auth enabled
Stop the instance first
This command only updates catalog metadata. Always stop the physical instance before running this command. If the instance is still running, it may cause inconsistencies in the cluster.
Examples
- Clean up catalog after killing a node
- Clean up catalog without confirmation
- Clean up catalog on a remote server
In the examples below, replace the following:
NODE_ID: The node identifier for the stopped instanceAUTH_TOKEN: Authentication token with sufficient privilegesINFLUXDB_HOST: Host URL of the running InfluxDB 3 Enterprise server
Clean up catalog after killing a node
This example shows the typical workflow: first stop the instance, then clean up the catalog.
# First, stop the physical instance (for example, using kill)
kill -9 <PID>
# Then, clean up the catalog
influxdb3 stop node --node-id NODE_IDThe command prompts for confirmation.
Clean up catalog without confirmation
influxdb3 stop node --node-id NODE_ID --forceClean up catalog on a remote server
influxdb3 stop node \
--host INFLUXDB_HOST \
--node-id NODE_ID \
--token AUTH_TOKENVerify node status
After stopping a node, verify its status using the influxdb3 show nodes command:
influxdb3 show nodesThe stopped node appears with state: "stopped" in the output.
Was this page helpful?
Thank you for your feedback!
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for InfluxDB 3 Enterprise and this documentation. To find support, use the following resources:
Customers with an annual or support contract can contact InfluxData Support. Customers using a trial license can email trial@influxdata.com for assistance.