Knowledge Base

Configuring Neo4j to operate on privileged ports

In some environments, users are required to run Neo4j on ports lower than 1024 due to corporate policies. The following is a sample configuration showing how to configure Neo4j 3.5 and newer to listen on those ports.

Refer to a path/to/file.

  1. Configure neo4j.conf to set the http, https and bolt ports.

    On a debian installation it would look like this:

    In the /etc/neo4j/pre-neo4j.sh file, configure this as follows:

    # HTTPS
    $ echo "dbms_connector_https_enabled" "${dbms_connector_https_enabled:=true}"
    $ echo "dbms_connector_https_listen_address" "${dbms_connector_https_listen_address:=0.0.0.0:80}"
    
    # HTTP
    $ echo "dbms_connector_http_enabled" "${dbms_connector_http_enabled:=false}"
    $ echo "dbms_connector_http_listen_address" "${dbms_connector_http_listen_address:=0.0.0.0:7474}"
    
    # BOLT
    $ echo "dbms_connector_bolt_enabled" "${dbms_connector_bolt_enabled:=true}"
    $ echo "dbms_connector_bolt_listen_address" "${dbms_connector_bolt_listen_address:=0.0.0.0:8080}"
    $ echo "dbms_connector_bolt_tls_level" "${dbms_connector_bolt_tls_level:=REQUIRED}"

    On a tar installation it would look like this:

    # Bolt connector
    dbms.connector.bolt.enabled=true
    #dbms.connector.bolt.tls_level=OPTIONAL
    dbms.connector.bolt.listen_address=:8080
    
    # HTTP Connector. There can be zero or one HTTP connectors.
    dbms.connector.http.enabled=false
    #dbms.connector.http.listen_address=:7474
    
    # HTTPS Connector. There can be zero or one HTTPS connectors.
    dbms.connector.https.enabled=true
    dbms.connector.https.listen_address=:80
  2. Identify the location of the java installation.

    $ readlink -f $(which java)
  3. Bind the java executable to the privileged ports (use the path found in step 2).

    $ sudo setcap cap_net_bind_service=+eip /usr/lib/jvm/java-8-openjdk-amd64/jre/bin/java
  4. Neo4j should start and allow access via https on port 80.