From 0e6c56749f11e438cacd7ad568f39f60b9aa5f76 Mon Sep 17 00:00:00 2001 From: Reneta Popova Date: Mon, 6 Oct 2025 14:08:12 +0100 Subject: [PATCH 1/8] Improve Windows installation --- modules/ROOT/pages/installation/osx.adoc | 4 +- modules/ROOT/pages/installation/windows.adoc | 139 ++++++++++--------- 2 files changed, 79 insertions(+), 64 deletions(-) diff --git a/modules/ROOT/pages/installation/osx.adoc b/modules/ROOT/pages/installation/osx.adoc index 3f08bdc7b..511970c5d 100644 --- a/modules/ROOT/pages/installation/osx.adoc +++ b/modules/ROOT/pages/installation/osx.adoc @@ -10,9 +10,9 @@ If it is not already installed, get link:https://openjdk.org/[OpenJDK 21] or lin You can install Neo4j on macOS either by downloading and extracting a TAR archive or by using the Homebrew package manager. -=== Install Neo4j using a tar archive +=== Install Neo4j using a TAR archive -. Download the Linux/Mac Executable {neo4j-version-exact} (TAR) release from link:{neo4j-download-center-uri}[Neo4j Deployment Center]. +. Download the Linux / Mac Executable {neo4j-version-exact} (tar) release from link:{neo4j-download-center-uri}[Neo4j Deployment Center]. . Extract the contents of the archive, using `tar -xf ` or by double-clicking the file. . Place the extracted files in a permanent home on your server and set the environment variable `NEO4J_HOME` to point to the extracted directory, for example, `export NEO4J_HOME=/path/to/_` to make it easier to refer to it later. . (Recommended) xref:configuration/file-locations.adoc#file-locations-file-locations[Change the default locations] of the _data_, _conf_, _certificates_, _licenses_, and _plugins_ (if you plan to use custom plugins) directories by setting the environment variable `NEO4J_CONF` and the respective xref:configuration/configuration-settings.adoc#_server_directories_settings[`server.directories.*`] settings to point to the desired locations. diff --git a/modules/ROOT/pages/installation/windows.adoc b/modules/ROOT/pages/installation/windows.adoc index 163f7fafa..91571b735 100644 --- a/modules/ROOT/pages/installation/windows.adoc +++ b/modules/ROOT/pages/installation/windows.adoc @@ -3,58 +3,46 @@ = Windows installation Before you install Neo4j on Windows, check xref:installation/requirements.adoc[System Requirements] to see if your setup is suitable. - +If it is not already installed, get link:https://www.oracle.com/java/technologies/downloads/?er=221886[OracleJDK 21] or link:https://www.azul.com/downloads/[ZuluJDK 21]. [[windows-console]] -== Windows console application +== Install and start Neo4j -. If it is not already installed, get link:https://openjdk.org/[OpenJDK 21] or link:https://www.oracle.com/java/technologies/downloads/?er=221886[Oracle Java 21]. -. Download the latest release from link:{neo4j-download-center-uri}[Neo4j Deployment Center]. -+ -Select the appropriate ZIP distribution. -. Check that the SHA hash of the downloaded file is correct: -.. To find the correct SHA hash, go to Neo4j Deployment Center and click `SHA-256`, which is located below your downloaded file. -.. Using the appropriate commands for your platform, display the `SHA-256` hash for the file that you downloaded. -.. Ensure that the two are identical. -. Right-click the downloaded file and click *Extract All*. +You can install Neo4j on Windows either by downloading and extracting a ZIP archive, by running it as a Windows service, or by using the Windows PowerShell module. + +=== Install Neo4j using a zip archive + +. Download the Windows Executable {neo4j-version-exact} (zip) release from link:{neo4j-download-center-uri}[Neo4j Deployment Center]. +. Right-click the downloaded file and select *Extract All* to extract the contents of the archive. . Place the extracted files in a permanent home on your server and set the environment variable `NEO4J_HOME` to point to the extracted directory, for example, `export NEO4J_HOME=\path\to\_` to make it easier to refer to it later. -. xref:configuration/file-locations.adoc#file-locations-file-locations[Change the default locations] of the _data_, _conf_, _certificates_, _licenses_, and _plugins_ (if you plan to use custom plugins) directories by setting the environment variable `NEO4J_CONF` and the respective xref:configuration/configuration-settings.adoc#_server_directories_settings[`server.directories.*`] settings to point to the desired locations. +. (Recommended) xref:configuration/file-locations.adoc#file-locations-file-locations[Change the default locations] of the _data_, _conf_, _certificates_, _licenses_, and _plugins_ (if you plan to use custom plugins) directories by setting the environment variable `NEO4J_CONF` and the respective xref:configuration/configuration-settings.adoc#_server_directories_settings[`server.directories.*`] settings to point to the desired locations. + [NOTE] ==== Storing your Neo4j files outside `NEO4J_HOME` will simplify the upgrade process later because you will be able to replace the DBMS binaries without affecting the configuration and state. Otherwise, these Neo4j files will remain in the old installation folder and may be accidentally overwritten during an upgrade or deleted during a subsequent uninstall. ==== -. Accept either the commercial or the evaluation license agreement before running the Neo4j Enterprise Edition. +. label:enterprise[Enterprise Edition] Accept either the commercial or the evaluation license agreement. If you are using Community Edition, you can skip this step. * Use one of the following options to accept the commercial license agreement. See the link:https://legal.neo4j.com/[Neo4j licensing] page for details on the available agreements. -+ -** Set it as an environment variable using `set NEO4J_ACCEPT_LICENSE_AGREEMENT=yes`. +** Set the environment variable `NEO4J_ACCEPT_LICENSE_AGREEMENT=yes`. ** Run `$NEO4J_HOME\bin\neo4j-admin server license --accept-commercial` -* Use one of the following options to accept the link:https://neo4j.com/terms/enterprise_us/[Neo4j Evaluation Agreement for Neo4j Software]. -+ -** Set it as an environment variable using `set NEO4J_ACCEPT_LICENSE_AGREEMENT=eval`. +* Use one of the following options to accept the link:https://neo4j.com/terms/enterprise_us/[Neo4j Evaluation Agreement for Neo4j Software]: +** Set the environment variable `NEO4J_ACCEPT_LICENSE_AGREEMENT=eval`. ** Run `$NEO4J_HOME\bin\neo4j-admin server license --accept-evaluation`. . Before starting up the database for the first time, it is recommended to use the `set-initial-password` command of `neo4j-admin` to define the password for the native user `neo4j`. + If the password is not set explicitly using this method, it will be set to the default password `neo4j`. In that case, you will be prompted to change the default password at first login. + For more information, see xref:configuration/set-initial-password.adoc[]. -. Start Neo4j: -* To run Neo4j as a console application, use: `$NEO4J_HOME\bin\neo4j console`. -* To install Neo4j as a service use: `$NEO4J_HOME\bin\neo4j windows-service install`. -For additional commands and to learn about the Windows PowerShell module included in the Zip file, see xref:installation/windows.adoc#powershell[Windows PowerShell module]. -. Open _\http://localhost:7474/_ in your web browser. -. Connect using the username `neo4j` with your password or the default password `neo4j`. -You will then be prompted to change the password. -. Stop the server by typing `Ctrl-C` in the console. +. Start Neo4j as a console application by running `$NEO4J_HOME\bin\neo4j console` in your command prompt. [[windows-service]] -== Windows service +=== Install Neo4j as a Windows service -Neo4j can also be run as a Windows service. +You can install Neo4j as a Windows service. [WARNING] ==== @@ -62,19 +50,24 @@ By default, the Neo4j Windows service runs as the LocalSystem account, which has This is a security risk, and it is recommended to run the service as a user without full LocalSystem privileges. ==== -=== Install the Windows service - -Install the service with `bin\neo4j windows-service install`, and start it with `bin\neo4j start`. - -The available commands for `bin\neo4j` are: `version`, `help`, `console`, `start`, `stop`, `restart`, `status`, and `windows-service`. +. Create a user account that the Neo4j service will run as. +. Follow the steps in the <<_install_neo4j_using_a_zip_archive, Install Neo4j using a zip archive>> section to download and extract the ZIP archive and set up the environment variables. +. Run the following command in your command prompt to install the service, replacing `` and `` with the credentials of the user account created in the first step: ++ +[source, bash] +---- +bin\neo4j windows-service --username --password install +---- +. Start the Neo4j service by running `bin\neo4j start` [NOTE] ==== When installing a new release of Neo4j, you must first run `bin\neo4j windows-service uninstall` on any previously installed versions. +Then, install the new version using the `install` command as described above. ==== [[windows-update-service]] -=== Change the Windows service configuration +=== Change the Neo4j Windows service configuration When Neo4j is installed as a service, the Java options are stored in the service configuration file. If you want to change any of these options or environment variables after the service is installed, you must update and restart the service for the changes to take effect. @@ -116,55 +109,49 @@ bin\neo4j restart ==== [[powershell]] -== Windows PowerShell module - -The Neo4j PowerShell module allows administrators to: - -* Install, start, and stop Neo4j Windows® Services. -* Start tools, such as `Neo4j Admin` and `Cypher Shell`. +=== Install Neo4j using PowerShell +The Neo4j PowerShell module allows administrators to install, start, and stop Neo4j Windows® Services, as well as perform various administrative tasks using `Neo4j Admin` and `Cypher Shell`. The PowerShell module is installed as part of the https://neo4j.com/deployment-center/[ZIP file] distributions of Neo4j. [[powershell-requirements]] -=== System requirements - -* Requires PowerShell v2.0 or above. -* Supported on either 32 or 64-bit operating systems. +* System requirements: +* PowerShell 5.1 or later (PowerShell 7.x recommended). +* Supported on 64-bit Windows operating systems. -[[powershell-windows]] -=== Manage Neo4j on Windows +. Unblock the downloaded Neo4j ZIP file if necessary to be able to import the module: -On Windows, it is sometimes necessary to _Unblock_ a downloaded ZIP file before you can import its contents as a module. - -. Right-click on the ZIP file and choose *Properties*. + +.. Right-click on the ZIP file and choose *Properties*. + A dialog appears with an *Unblock* button. -. Click the *Unblock* button to enable the import of the module. +.. Click the *Unblock* button to enable the import of the module. + Running scripts has to be enabled on the system. This can, for example, be achieved by executing the following from an elevated PowerShell prompt: + [source,powershell] ---- -Set-ExecutionPolicy -ExecutionPolicy RemoteSigned +Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser ---- + For more information, see https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies?view=powershell-7.5[About execution policies]. The PowerShell module displays a warning if it detects that you do not have administrative rights. - -[[powershell-module-import]] -=== Import the module file - -The module file is located in the _bin_ directory of your Neo4j installation. - -. Assuming that Neo4j is installed in _C:\Neo4j_, run the following command to import the module: +. Set the environment variable `NEO4J_HOME` to point to the directory where you have installed Neo4j. +For example, you can run the following command in your PowerShell session, assuming you have installed Neo4j in `C:\Neo4j`: ++ +[source,powershell] +---- +$env:NEO4J_HOME = "C:\Neo4j" +---- ++ +. Import the Neo4j PowerShell module by running the following command: + [source,powershell] ---- -Import-Module C:\Neo4j\bin\Neo4j-Management.psd1 +Import-Module $env:NEO4J_HOME\bin\Neo4j-Management.psd1 ---- + This adds the module to the current session. @@ -176,11 +163,14 @@ This adds the module to the current session. Invoke-Neo4j console ---- +[TIP] +==== To stop the server, use `Ctrl-C` in the console window, created by the command. +==== [[powershell-help]] -=== Inspect the module +==== Inspect the module You can get all available commands in the module by running the following command: @@ -218,7 +208,7 @@ Get-Help Invoke-Neo4j -examples [[powershell-examples]] -=== Example usage +==== Example usage * List of available commands: + @@ -250,10 +240,35 @@ Invoke-Neo4jAdmin [[powershell-common-parameters]] -=== Common PowerShell parameters +==== Common PowerShell parameters The module commands support the common PowerShell parameter of `Verbose`. +== Access Neo4j + +By default, Neo4j Community Edition does not include graph tools such as visualization, data exploration, and monitoring. +However, you can use the Neo4j Aura console to access these features for free. +No subscription is required. + +. Sign up or log in to the link:http://console-preview.neo4j.io/self-managed[Aura Console]. +. On the *Instances* page, click the *Self-managed* tab and then *+ Add deployment* button. +. Select *URL Connection*. +. Provide a *Name* and *Connection URL*. +If you have installed Neo4j locally on your system, you can connect to _\http://localhost:7474_. +. Click the *Connect* dropdown to launch various graph tools such as *Query*, *Explore*, and *Dashboards*. +. Type the username `neo4j` and your password or the default password `neo4j`. +You will be prompted to change the latter upon first login. ++ +image::aura-add-deployment.png[width=800,alt=Aura add self-managed deployment] + +You are now connected and can use the Aura Console to run Cypher queries, visualize graphs, and optionally monitor your local Neo4j database in Neo4j Aura. +For details, see link:https://neo4j.com/docs/getting-started/#_work_with_data[Get started with Neo4j]. + +Alternatively, you can use the Neo4j Browser, a web-based user interface for interacting with Neo4j that is included with the Neo4j installation. +To access the Neo4j Browser, open a web browser and navigate to _\http://localhost:7474_. +Connect using the username `neo4j` with your password or the default password `neo4j`. +If the default password is used, you will be prompted to change it upon first login. + == Uninstall Neo4j Here are the steps to uninstall Neo4j on Windows: From 8e38f29de3137005b4922d00910a3206cf266ab8 Mon Sep 17 00:00:00 2001 From: Reneta Popova Date: Mon, 6 Oct 2025 14:08:49 +0100 Subject: [PATCH 2/8] update the link to Aura console --- modules/ROOT/pages/installation/windows.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/installation/windows.adoc b/modules/ROOT/pages/installation/windows.adoc index 91571b735..d75cff90e 100644 --- a/modules/ROOT/pages/installation/windows.adoc +++ b/modules/ROOT/pages/installation/windows.adoc @@ -250,7 +250,7 @@ By default, Neo4j Community Edition does not include graph tools such as visuali However, you can use the Neo4j Aura console to access these features for free. No subscription is required. -. Sign up or log in to the link:http://console-preview.neo4j.io/self-managed[Aura Console]. +. Sign up or log in to the link:https://console-preview.neo4j.io/self-managed[Aura Console]. . On the *Instances* page, click the *Self-managed* tab and then *+ Add deployment* button. . Select *URL Connection*. . Provide a *Name* and *Connection URL*. From 6c938618132166720a1c943810b90e3ac6716e09 Mon Sep 17 00:00:00 2001 From: Reneta Popova Date: Mon, 6 Oct 2025 15:44:12 +0100 Subject: [PATCH 3/8] upate the steps for powershell --- modules/ROOT/pages/installation/windows.adoc | 90 ++++++++------------ 1 file changed, 36 insertions(+), 54 deletions(-) diff --git a/modules/ROOT/pages/installation/windows.adoc b/modules/ROOT/pages/installation/windows.adoc index d75cff90e..2b013163a 100644 --- a/modules/ROOT/pages/installation/windows.adoc +++ b/modules/ROOT/pages/installation/windows.adoc @@ -113,31 +113,27 @@ bin\neo4j restart The Neo4j PowerShell module allows administrators to install, start, and stop Neo4j Windows® Services, as well as perform various administrative tasks using `Neo4j Admin` and `Cypher Shell`. The PowerShell module is installed as part of the https://neo4j.com/deployment-center/[ZIP file] distributions of Neo4j. - - -[[powershell-requirements]] -* System requirements: - -* PowerShell 5.1 or later (PowerShell 7.x recommended). -* Supported on 64-bit Windows operating systems. +It requires PowerShell 5.1 or later (PowerShell 7.x recommended) and is supported on 64-bit Windows operating systems. . Unblock the downloaded Neo4j ZIP file if necessary to be able to import the module: - .. Right-click on the ZIP file and choose *Properties*. + A dialog appears with an *Unblock* button. .. Click the *Unblock* button to enable the import of the module. -+ -Running scripts has to be enabled on the system. -This can, for example, be achieved by executing the following from an elevated PowerShell prompt: +.. Click *Apply* and then *OK* to close the dialog. +. Right-click the downloaded file and select *Extract All* to extract the contents of the archive. +. Run the following command from an elevated PowerShell prompt to enable script execution: + [source,powershell] ---- -Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser +Set-ExecutionPolicy -ExecutionPolicy RemoteSigned ---- + For more information, see https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies?view=powershell-7.5[About execution policies]. - ++ +[NOTE] +==== The PowerShell module displays a warning if it detects that you do not have administrative rights. +==== . Set the environment variable `NEO4J_HOME` to point to the directory where you have installed Neo4j. For example, you can run the following command in your PowerShell session, assuming you have installed Neo4j in `C:\Neo4j`: @@ -146,7 +142,6 @@ For example, you can run the following command in your PowerShell session, assum ---- $env:NEO4J_HOME = "C:\Neo4j" ---- -+ . Import the Neo4j PowerShell module by running the following command: + [source,powershell] @@ -172,15 +167,15 @@ To stop the server, use `Ctrl-C` in the console window, created by the command. [[powershell-help]] ==== Inspect the module -You can get all available commands in the module by running the following command: - +. Get all available commands in the module by running the following command: ++ [source,powershell] ---- Get-Command -Module Neo4j-Management ---- - ++ The output should be similar to the following: - ++ [source, shell, subs="attributes"] ---- CommandType Name Version Source @@ -192,57 +187,44 @@ Function Invoke-Neo4jImport {neo4j-version-exact} N Function Invoke-Neo4jShell {neo4j-version-exact} Neo4j-Management ---- -The module also supports the standard PowerShell help commands - -[source,powershell] ----- -Get-Help Invoke-Neo4j ----- - -Run the following to see examples of help commands: - -[source,powershell] ----- -Get-Help Invoke-Neo4j -examples ----- - - -[[powershell-examples]] -==== Example usage - -* List of available commands: +. See what each command does by running the following command, replacing `` with the name of the command you want to inspect, for example, `Invoke-Neo4j`: + [source,powershell] ---- -Invoke-Neo4j +Get-Help ---- -* Current status of the Neo4j service: +. Run the following to see some usage examples of that command: + [source,powershell] ---- -Invoke-Neo4j status +Get-Help -examples ---- - -* Install the service with verbose output: + -[source,powershell] ----- -Invoke-Neo4j windows-service -Verbose ----- +.Usage examples +[options="header", cols="3m,1a"] +|==== +| Command +| Description -* Available commands for administrative tasks: -+ -[source,powershell] ----- -Invoke-Neo4jAdmin ----- +| Invoke-Neo4j +| Outputs the available commands. + +| Invoke-Neo4j status +| Current status of the Neo4j service. +| Invoke-Neo4j windows-service +| Install the service. -[[powershell-common-parameters]] -==== Common PowerShell parameters +| Invoke-Neo4jAdmin +| Available commands for administrative tasks. +|==== +[TIP] +==== The module commands support the common PowerShell parameter of `Verbose`. +You can add `-Verbose` to any command to get more detailed output. +==== == Access Neo4j From 70b6444c50747703fba056367ba6a153c8dbcf04 Mon Sep 17 00:00:00 2001 From: David Pond Date: Wed, 8 Oct 2025 10:18:02 +0100 Subject: [PATCH 4/8] Update windows.adoc --- modules/ROOT/pages/installation/windows.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/modules/ROOT/pages/installation/windows.adoc b/modules/ROOT/pages/installation/windows.adoc index 2b013163a..9e66f4bea 100644 --- a/modules/ROOT/pages/installation/windows.adoc +++ b/modules/ROOT/pages/installation/windows.adoc @@ -77,7 +77,7 @@ To update the service, run `bin\neo4j windows-service update`. Then restart the service to run it with the new configuration. The same applies to the path to where Java is installed on the system. -If the path changes, for example when upgrading to a new version of Java, it is necessary to run the `update-service` command and restart the service. +If the path changes, for example when upgrading to a new version of Java, it is necessary to run the `bin\neo4j windows-service update` command and restart the service. Then, the new Java location will be used by the service. .Update service example @@ -268,4 +268,4 @@ bin\neo4j windows-service uninstall [source, shell] --- rmdir NEO4J_HOME ---- \ No newline at end of file +--- From dc06cdf6c24abd91992902abfad2a95d548e3b69 Mon Sep 17 00:00:00 2001 From: Reneta Popova Date: Wed, 8 Oct 2025 12:54:24 +0100 Subject: [PATCH 5/8] apply suggestions from review --- modules/ROOT/pages/installation/windows.adoc | 33 ++++++++++---------- 1 file changed, 17 insertions(+), 16 deletions(-) diff --git a/modules/ROOT/pages/installation/windows.adoc b/modules/ROOT/pages/installation/windows.adoc index 9e66f4bea..77c0ce08d 100644 --- a/modules/ROOT/pages/installation/windows.adoc +++ b/modules/ROOT/pages/installation/windows.adoc @@ -14,7 +14,7 @@ You can install Neo4j on Windows either by downloading and extracting a ZIP arch . Download the Windows Executable {neo4j-version-exact} (zip) release from link:{neo4j-download-center-uri}[Neo4j Deployment Center]. . Right-click the downloaded file and select *Extract All* to extract the contents of the archive. -. Place the extracted files in a permanent home on your server and set the environment variable `NEO4J_HOME` to point to the extracted directory, for example, `export NEO4J_HOME=\path\to\_` to make it easier to refer to it later. +. Place the extracted files in a permanent home on your server and set the environment variable `NEO4J_HOME` to point to the extracted directory, for example, `setx NEO4J_HOME "C:\neo4j\neo4j-"` to make it easier to refer to it later. . (Recommended) xref:configuration/file-locations.adoc#file-locations-file-locations[Change the default locations] of the _data_, _conf_, _certificates_, _licenses_, and _plugins_ (if you plan to use custom plugins) directories by setting the environment variable `NEO4J_CONF` and the respective xref:configuration/configuration-settings.adoc#_server_directories_settings[`server.directories.*`] settings to point to the desired locations. + [NOTE] @@ -27,16 +27,16 @@ If you are using Community Edition, you can skip this step. * Use one of the following options to accept the commercial license agreement. See the link:https://legal.neo4j.com/[Neo4j licensing] page for details on the available agreements. ** Set the environment variable `NEO4J_ACCEPT_LICENSE_AGREEMENT=yes`. -** Run `$NEO4J_HOME\bin\neo4j-admin server license --accept-commercial` +** Run `%NEO4J_HOME%\bin\neo4j-admin server license --accept-commercial` * Use one of the following options to accept the link:https://neo4j.com/terms/enterprise_us/[Neo4j Evaluation Agreement for Neo4j Software]: ** Set the environment variable `NEO4J_ACCEPT_LICENSE_AGREEMENT=eval`. -** Run `$NEO4J_HOME\bin\neo4j-admin server license --accept-evaluation`. +** Run `%NEO4J_HOME%\bin\neo4j-admin server license --accept-evaluation`. . Before starting up the database for the first time, it is recommended to use the `set-initial-password` command of `neo4j-admin` to define the password for the native user `neo4j`. + If the password is not set explicitly using this method, it will be set to the default password `neo4j`. In that case, you will be prompted to change the default password at first login. + For more information, see xref:configuration/set-initial-password.adoc[]. -. Start Neo4j as a console application by running `$NEO4J_HOME\bin\neo4j console` in your command prompt. +. Start Neo4j as a console application by running `%NEO4J_HOME%\bin\neo4j console` in your command prompt. [[windows-service]] @@ -50,19 +50,20 @@ By default, the Neo4j Windows service runs as the LocalSystem account, which has This is a security risk, and it is recommended to run the service as a user without full LocalSystem privileges. ==== -. Create a user account that the Neo4j service will run as. +. Create a user account that the Neo4j service will run as using using services.msc, or the sc (Service Control) command. +You can use an existing user account, but it must have the `Log on as a service` right. . Follow the steps in the <<_install_neo4j_using_a_zip_archive, Install Neo4j using a zip archive>> section to download and extract the ZIP archive and set up the environment variables. -. Run the following command in your command prompt to install the service, replacing `` and `` with the credentials of the user account created in the first step: +. Run the following command in your command prompt to install the service: + [source, bash] ---- -bin\neo4j windows-service --username --password install +%NEO4J_HOME%\bin\neo4j windows-service install ---- -. Start the Neo4j service by running `bin\neo4j start` +. Start the Neo4j service by running `%NEO4J_HOME%\bin\neo4j start`. [NOTE] ==== -When installing a new release of Neo4j, you must first run `bin\neo4j windows-service uninstall` on any previously installed versions. +When installing a new release of Neo4j, you must first run `%NEO4J_HOME%\bin\neo4j windows-service uninstall` on any previously installed versions. Then, install the new version using the `install` command as described above. ==== @@ -73,11 +74,11 @@ When Neo4j is installed as a service, the Java options are stored in the service If you want to change any of these options or environment variables after the service is installed, you must update and restart the service for the changes to take effect. For example, updating the value of `server.memory.heap.initial_size` in the default xref:configuration/file-locations.adoc[_neo4j.conf_] file or by using the `NEO4J_CONF` environment variable will not automatically apply the changes. The service needs to be updated and restarted to pick them up. -To update the service, run `bin\neo4j windows-service update`. +To update the service, run ``%NEO4J_HOME%\bin\neo4j windows-service update`. Then restart the service to run it with the new configuration. The same applies to the path to where Java is installed on the system. -If the path changes, for example when upgrading to a new version of Java, it is necessary to run the `bin\neo4j windows-service update` command and restart the service. +If the path changes, for example when upgrading to a new version of Java, it is necessary to run the `%NEO4J_HOME%\bin\neo4j windows-service update` command and restart the service. Then, the new Java location will be used by the service. .Update service example @@ -85,7 +86,7 @@ Then, the new Java location will be used by the service. . Install service + ---- -bin\neo4j windows-service install +%NEO4J_HOME%\bin\neo4j windows-service install ---- . Change memory configuration @@ -98,13 +99,13 @@ echo server.memory.heap.initial_size=16g >> conf\neo4j.conf . Update service + ---- -bin\neo4j windows-service update +%NEO4J_HOME%\bin\neo4j windows-service update ---- . Restart service + ---- -bin\neo4j restart +%NEO4J_HOME%\bin\neo4j restart ---- ==== @@ -261,11 +262,11 @@ Here are the steps to uninstall Neo4j on Windows: + [source, shell] --- -bin\neo4j windows-service uninstall +%NEO4J_HOME%\bin\neo4j windows-service uninstall --- . Delete _NEO4J_HOME_: + [source, shell] --- rmdir NEO4J_HOME ---- +--- \ No newline at end of file From 1d389c5418d8175dbbfaeb481e031650e01650f9 Mon Sep 17 00:00:00 2001 From: Reneta Popova Date: Fri, 10 Oct 2025 16:03:07 +0100 Subject: [PATCH 6/8] fix the output and update the powershell requirements as per the code --- modules/ROOT/pages/installation/windows.adoc | 14 ++++++-------- 1 file changed, 6 insertions(+), 8 deletions(-) diff --git a/modules/ROOT/pages/installation/windows.adoc b/modules/ROOT/pages/installation/windows.adoc index 77c0ce08d..cfb1cd789 100644 --- a/modules/ROOT/pages/installation/windows.adoc +++ b/modules/ROOT/pages/installation/windows.adoc @@ -114,7 +114,7 @@ echo server.memory.heap.initial_size=16g >> conf\neo4j.conf The Neo4j PowerShell module allows administrators to install, start, and stop Neo4j Windows® Services, as well as perform various administrative tasks using `Neo4j Admin` and `Cypher Shell`. The PowerShell module is installed as part of the https://neo4j.com/deployment-center/[ZIP file] distributions of Neo4j. -It requires PowerShell 5.1 or later (PowerShell 7.x recommended) and is supported on 64-bit Windows operating systems. +It requires PowerShell 2.0 or later and is supported on 64-bit Windows operating systems. . Unblock the downloaded Neo4j ZIP file if necessary to be able to import the module: .. Right-click on the ZIP file and choose *Properties*. + @@ -179,13 +179,11 @@ The output should be similar to the following: + [source, shell, subs="attributes"] ---- -CommandType Name Version Source ------------ ---- ------- ------ -Function Invoke-Neo4j {neo4j-version-exact} Neo4j-Management -Function Invoke-Neo4jAdmin {neo4j-version-exact} Neo4j-Management -Function Invoke-Neo4jBackup {neo4j-version-exact} Neo4j-Management -Function Invoke-Neo4jImport {neo4j-version-exact} Neo4j-Management -Function Invoke-Neo4jShell {neo4j-version-exact} Neo4j-Management +CommandType Name Version Source +----------- ---- ------- ------ +Function Get-Args 3.0.0 Neo4j-Management +Function Invoke-Neo4j 3.0.0 Neo4j-Management +Function Invoke-Neo4jAdmin 3.0.0 Neo4j-Management ---- . See what each command does by running the following command, replacing `` with the name of the command you want to inspect, for example, `Invoke-Neo4j`: From 26303f3309f225a6fb5c1a949e0a238f5257f3de Mon Sep 17 00:00:00 2001 From: Reneta Popova Date: Fri, 17 Oct 2025 12:42:15 +0200 Subject: [PATCH 7/8] Update modules/ROOT/pages/installation/windows.adoc Co-authored-by: Natalia Ivakina <82437520+NataliaIvakina@users.noreply.github.com> --- modules/ROOT/pages/installation/windows.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/installation/windows.adoc b/modules/ROOT/pages/installation/windows.adoc index cfb1cd789..7e5f5f9d6 100644 --- a/modules/ROOT/pages/installation/windows.adoc +++ b/modules/ROOT/pages/installation/windows.adoc @@ -74,7 +74,7 @@ When Neo4j is installed as a service, the Java options are stored in the service If you want to change any of these options or environment variables after the service is installed, you must update and restart the service for the changes to take effect. For example, updating the value of `server.memory.heap.initial_size` in the default xref:configuration/file-locations.adoc[_neo4j.conf_] file or by using the `NEO4J_CONF` environment variable will not automatically apply the changes. The service needs to be updated and restarted to pick them up. -To update the service, run ``%NEO4J_HOME%\bin\neo4j windows-service update`. +To update the service, run `%NEO4J_HOME%\bin\neo4j windows-service update`. Then restart the service to run it with the new configuration. The same applies to the path to where Java is installed on the system. From 3576de00bba934486c66014dd08ce4576600757c Mon Sep 17 00:00:00 2001 From: Reneta Popova Date: Fri, 17 Oct 2025 13:06:56 +0200 Subject: [PATCH 8/8] Update modules/ROOT/pages/installation/windows.adoc --- modules/ROOT/pages/installation/windows.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/installation/windows.adoc b/modules/ROOT/pages/installation/windows.adoc index 7e5f5f9d6..36c581999 100644 --- a/modules/ROOT/pages/installation/windows.adoc +++ b/modules/ROOT/pages/installation/windows.adoc @@ -114,7 +114,7 @@ echo server.memory.heap.initial_size=16g >> conf\neo4j.conf The Neo4j PowerShell module allows administrators to install, start, and stop Neo4j Windows® Services, as well as perform various administrative tasks using `Neo4j Admin` and `Cypher Shell`. The PowerShell module is installed as part of the https://neo4j.com/deployment-center/[ZIP file] distributions of Neo4j. -It requires PowerShell 2.0 or later and is supported on 64-bit Windows operating systems. +It requires PowerShell 5.1 or later (PowerShell 7.x recommended) and is supported on 64-bit Windows operating systems. . Unblock the downloaded Neo4j ZIP file if necessary to be able to import the module: .. Right-click on the ZIP file and choose *Properties*. +