Self-host Neo4j with Levelrail

A graph database with the Cypher query language, Community Edition, including the browser console.

  • Memory1 GiB
  • Archarm64
  • Services1

How to self-host Neo4j

  1. Pull the images

    One image is pulled on your server.

    Show images
    • neo4j:5.26-community
  2. Create the app

    One service starts in a single Compose app, with 1 named volume mount for your data, on ports 7474, 7687.

  3. Fill in the secrets

    1 secret is generated and stored encrypted, you do not have to fill in anything.

  4. Open it

    Without a domain the app gets an sslip.io address; add --domain SERVICE=HOST to use your own.

Neo4j requirements

Memory
About 1 GiB
Architectures
amd64 image published, arm64 image published
Ports
7474, 7687
Domain
Optional, an sslip.io address is used without one
Settings
none to fill in
License
not yet recorded
  • Listed. It is in the catalog but not verified. Back up the data volume before changing an image tag.

Install Levelrail first

On a server with Levelrail running, run the command above, or open the dashboard: Apps, New app, Browse templates, then Neo4j. New to Levelrail? Install it on a fresh VPS first.

docker pull ghcr.io/glincker/levelrail:latest

Then levelrail-cli login --device. See Getting started and the Neo4j docs page.

Deploy Neo4j your way

Every format below deploys the same pinned images. Pick the one that fits how you work.

Deploy Neo4j from the CLI

Add --domain SERVICE=HOST to serve a service on your own domain, for example --domain neo4j=app.example.com.

levelrail-cli templates install neo4j --name my-neo4j

Deploy Neo4j with the API

Create a token in the dashboard first. Name, env and domains are the request fields.

curl -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  https://levelrail.example.com/api/v1/service-templates/neo4j/install \
  -d '{
    "name": "my-neo4j"
  }'

Neo4j configuration

Neo4j services

ServiceImagePortsVolumes
neo4j neo4j:5.26-community 7474, 7687 data -> /data

Neo4j environment variables

VariableServiceValue
NEO4J_AUTH neo4j Generated at deploy

Ports and volumes

Ports
7474, 7687
Volumes
1 named mount: data -> /data

Neo4j FAQ

How much memory does Neo4j need?

The catalog lists about 1 GiB of memory for Neo4j.

Does Neo4j run on arm64?

For Neo4j, an arm64 image is published; amd64 is image published.

Does Neo4j need configuration before it starts?

No. The template fills in its own defaults and generates secrets at deploy time.

Which ports does Neo4j use?

Neo4j listens on ports 7474 and 7687 inside the stack.

Where does Neo4j keep its data?

In a named volume: data mounted at /data.

Can I deploy Neo4j on Dokploy or Dokku?

The services and pinned images on this page can be run on any Docker host. The public Dokploy templates list we compared does not have an entry with the same id for Neo4j, so on Dokploy you would use a Docker Compose application with the file from this page. Dokku deploys container images with its own commands, so the pinned image neo4j:5.26-community is what you deploy there.

levelrail-cli templates install neo4j --name my-neo4j