update steps after discussing with PM

Author: renetapopova

modules/ROOT/images/aura-add-deployment.png

@@ -8,23 +8,24 @@ If it is not already installed, get link:https://openjdk.org/[OpenJDK 21] or lin
 [[osx-console]]
 == Install and start Neo4j
 
-You can run Neo4j as a console application on macOS.
+You can install Neo4j on macOS either by downloading and extracting a TAR archive or by using the Homebrew package manager.
 
-. Download the Linux/Mac Executable {neo4j-version-exact} (tar) release from link:{neo4j-download-center-uri}[Neo4j Deployment Center].
-. Verify the integrity of the downloaded file by checking the SHA-256 hash.
-It must match the hash provided on the download page below the download link.
-. Extract the contents of the archive, using `tar -xf` <filename> or by double-clicking the archive in Finder.
+=== Install Neo4j from the tar archive
+
+. 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` <filename> 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/_<NEO4J_HOME>` to make it easier to refer to it later.
-. (Optional) 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.
 ====
-. label:enterprise[Enterprise Edition] Accept either the commercial or the evaluation license agreement by one of the following methods:
+. 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.:
+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`
 * Use one of the following options to accept the link:https://neo4j.com/terms/enterprise_us/[Neo4j Evaluation Agreement for Neo4j Software]:
@@ -39,7 +40,7 @@ For more information, see xref:configuration/set-initial-password.adoc[].
 * To run Neo4j as a console application, use: `$NEO4J_HOME/bin/neo4j console`.
 * To run Neo4j in a background process, use: `$NEO4J_HOME/bin/neo4j start`.
 
-== Install Neo4j as a macOS service
+=== Install Neo4j as a macOS service
 
 The easiest way to install Neo4j as a service on macOS is to use the Homebrew package manager (see https://brew.sh/[Homebrew installation instructions]).
 
@@ -51,7 +52,7 @@ brew install neo4j
 ----
 +
 This command installs Neo4j Community Edition and sets it up as a service that can be managed using Homebrew.
-. (Optional) If you want to change the default directories or other settings, you can do so in the `neo4j.conf` file located at `/opt/homebrew/Cellar/neo4j/{neo4j-version-exact}/libexec/conf/neo4j.conf`.
+. (Recommended) If you want to change the default directories or other settings, you can do so in the `neo4j.conf` file located at `/opt/homebrew/Cellar/neo4j/{neo4j-version-exact}/libexec/conf/neo4j.conf`.
 If already started, changes to the configuration file will not take effect until you restart the Neo4j service using `brew services restart neo4j`.
 . Start Neo4j as a macOS service:
 +
@@ -70,53 +71,33 @@ brew services list
 
 Alternatively, if you want to install Neo4j Enterprise or prefer native service control, you can use the standard macOS system tools, such as `launchd`, to create a service based on the `neo4j` command.
 
-
 == Access Neo4j
 
-After starting Neo4j, you can access it using the Neo4j Aura console, Neo4j Browser, or Cypher Shell.
-
-=== Using the Neo4j Aura console
-
 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 in a cloud environment.
-
-. Log in to the Aura Console at https://console.neo4j.io/.
-. Connect to your Neo4j server by entering the connection details, such as the server address and port.
-//To add an example.
-. Type 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.
-. Once connected, you can use the Aura Console to run Cypher queries, visualize graphs, and monitor your local Neo4j in the cloud environment.
+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]
 
-=== Using Neo4j Browser
-The Neo4j Browser is a web-based user interface for interacting with Neo4j.
-To access the Neo4j Browser, open a web browser and navigate to:
+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].
 
-. _\http://localhost:7474/_ or the URL specified in your configuration.
-. Connect using the username `neo4j` with your password or the default password `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.
 
-=== Using Cypher Shell
-
-Cypher Shell is a command-line tool for executing Cypher queries against a Neo4j database.
-To use Cypher Shell, run the following command in your terminal:
-
-[source, shell]
-----
-$NEO4J_HOME/bin/cypher-shell -u neo4j -p <your_password>
-----
-
-Replace `<your_password>` with the password you set for the `neo4j` user.
-If you did not set a password, use `neo4j` as the password.
-
-If you are running Neo4j in console mode, you can also run Cypher Shell in the same terminal session:
-
-[source, shell]
-----
-$NEO4J_HOME/bin/cypher-shell
-----
-This will connect to the Neo4j instance running in the same terminal.
-
 == Logging
+
 Neo4j logs are written to the _logs_ directory under _NEO4J_HOME_.
 For detailed information about the log files, see xref:monitoring/logging.adoc[Logging].