Your download should begin automatically. Click here if it doesn't.

Graph Databases 2nd Edition

Discover how graph databases can help you manage and query highly connected data — with O’Reilly’s definitive book on Graph Databases.

Get your free book!

1. Install Neo4j

Mac Installation (dmg)

 

The installer includes the Java version needed for running Neo4j.

  1. Open the dmg file you just downloaded.
  2. Drag the 'Neo4j' icon into your Applications folder.
  3. Open Neo4j from your Applications folder. You might need to acknowledge that you downloaded the application from the Internet.
  4. Click on the 'Start' button to start the Neo4j server.
  5. Open the provided URL in your local web browser.
  6. Connect using the username 'neo4j' with default password 'neo4j'. You'll then be prompted to change the password.

Neo4j Operations Manual: OS X installation →

Linux/UNIX Install (tar)

 
 
  1. Open up your terminal/shell.
  2. Extract the contents of the archive, using:
    tar -xf <filecode>.
    For example,
    tar -xf neo4j-community-3.1.2-unix.tar.gz
  3. Place the extracted files in a permanent home on your server. The top level directory is referred to as NEO4J_HOME.
    • 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
    • For additional commands see the Unix tarball installation documentation.
  4. Visit http://localhost:7474 in your web browser.
  5. Connect using the username 'neo4j' with default password 'neo4j'. You'll then be prompted to change the password.

Neo4j Operations Manual: Linux Installation →

Windows (exe)

 
 

The installer includes the Java version needed for running Neo4j.

  1. Launch the installer you just downloaded. You might have to give the installer permission to make changes to your computer.
  2. Follow the prompts, and choose the option to Run Neo4j.
  3. Click on the 'Start' button to start the Neo4j server.
  4. Open the provided URL in your local web browser.
  5. Connect using the username 'neo4j' with default password 'neo4j'. You'll then be prompted to change the password.

Neo4j Operations Manual: Windows installation →

Windows (zip)

 
neo4j2-2  
  1. If it is not already installed, get OpenJDK 8 or Oracle Java 8, recommended for Neo4j 3.0.x Version 7 is recommended for releases prior to 2.3.0.
  2. Find the zip file you just downloaded and right-click, extract all.
  3. Place the extracted files in a permanent home on your server, for example D:\neo4j\. The top level directory is referred to as NEO4J_HOME.
    • To run Neo4j as a console application, use:
      <NEO4J_HOME>\bin\neo4j console
    • To install Neo4j as a service use:
      <NEO4J_HOME>\bin\neo4j install-service.
    • For additional commands and to learn about the Windows PowerShell module included in the Zip file, see the Windows installation documentation.
  4. Visit http://localhost:7474 in your web browser.
  5. Connect using the username 'neo4j' with default password 'neo4j'. You'll then be prompted to change the password.

Neo4j Operations Manual: Windows installation →

2. Open Neo4j Browser

Neo4j Browser - main panel

Start Up the Neo4j Browser

Visit: http://localhost:7474/

Once you create a new password for the 'neo4j' user upon visiting the Neo4j Browser the first time, you'll have full access to the Neo4j database.

The Neo4j Browser is a tool for developers to explore their Neo4j database, execute Cypher queries and see results in tabular or graph form. You can even use the Browser to:

3. Explore Sample Datasets

Neo4j Sample Datasets

 
Neo4j movie sample graph

Explore two sample datasets built into the Neo4j Browser using the following commands:
:play movie graph
:play northwind graph
Both datasets are easily accessible using the blue "Write Code" button under the "Jump into Code" section of the guides.

Neo4j is used by developers building applications for a wide range of use cases and industries. Graph databases are a great fit for any use case where a relationship-first approach is helpful, including content recommendations, network/IT analysis, fraud detection, Internet of Things(IoT) and more.  

Additional datasets

We're working on datasets for a variety of other uses cases. Are you looking for something in particular or have a suggestion? Reach out to devrel@neo4j.com.

4. Download Drivers

You've already seen the Neo4j Browser - which is your developer interface to the Neo4j graph database. Now it's time to write code in your favorite programming language so you can start building your application.

Get the official drivers for Javascript, Java, .NET, and Python

Additionally, the community has built a wide variety of other drivers in languages like PHP, Ruby, Go, Haskell and more.

5. Create Your Data Model

Creating Your First Data Model

Start with a small data model and then build out from there - Neo4j is naturally adaptive, so you can add new node labels, relationships and properties on the fly.

Example Data Models

The developer community has provided example data models and queries for a variety of use cases outlined in Neo4j GraphGists.

Data Import

Do you have some existing data you'd like to import? You can import your data from CSV files using the Cypher's LOAD CSV command. Learn more about import in the Neo4j Developer Manual: Load CSV and Importing CSV Data into Neo4j.

Of course, Neo4j believes in polyglot persistence as well - so we're happy if Neo4j is just one part of your overall architecture and storing your connected data, while your columnar, tabular and document data is stored elsewhere. Learn more about the various types of data integrations possible with Neo4j.

6. Get Help and Training