Skip to content

Remove problematic part from unbind docs #2570

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Sep 5, 2025
Merged

Remove problematic part from unbind docs #2570

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
fa44ee0
Remove problematic part from `unbind` docs
gfx54b Sep 5, 2025
4564277
Apply suggestions from code review
NataliaIvakina Sep 5, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions modules/ROOT/pages/clustering/clustering-advanced/unbind.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,11 @@ Therefore, it is strongly recommended to consult with Neo4j Support before using

Use the `unbind` command only when troubleshooting **a specific server** and remember there is no guarantee that the allocator will reassign the same databases to this server, potentially resulting in orphaned database stores.

The `unbind` command preserves all database stores on the server; and when the unbound server is restarted and enabled, it is seen as an entirely new server.
The `unbind` command preserves all database stores on the server; and when the unbound server is restarted, it is seen as an entirely new server.
Therefore, it will not host any of the databases it hosted before the operation.

In 2025.x, the `unbind` command cannot be used to convert a cluster member into a standalone server.
Instead, it is recommended to take backups, create the standalone server, and then use those backups to restore the databases.
====

[[unbind-command-syntax]]
Expand Down Expand Up @@ -79,10 +83,6 @@ You can use the `neo4j-admin server unbind` command to remove the cluster state
To remove the cluster state of a server, run the `neo4j-admin server unbind` command from the _<NEO4J_HOME>_ folder of that server.
When restarted, an unbound server rejoins the cluster as a new server and has to be enabled using the `ENABLE SERVER` command.

=== Turn a cluster member into a standalone server

To start the Neo4j server in single (standalone) mode after unbinding it from the cluster, verify that xref:configuration/configuration-settings.adoc#config_initial.server.mode_constraint[`initial.server.mode_constraint`] is set to `NONE` in xref:configuration/neo4j-conf.adoc[The neo4j.conf file].

=== Archive cluster state

If something goes wrong and debugging is needed, you can archive the cluster state, from the _<NEO4J_HOME>_ folder, run the `neo4j-admin server unbind` command with the arguments `--archive-cluster-state=true` and `--archive-path=<destination-folder>`:
Expand Down