On-premise install with DEB

This section describes how to complete the installation steps, started here, using a DEB package for Debian or Ubuntu systems.

Ensure that Java 8 (or higher, Java 11 recommended) is installed before proceeding with these installation steps.

java - version
java version "1.8.0_201"
Java(TM) SE Runtime Environment (build 1.8.0_201-b09)
Java HotSpot(TM) 64-Bit Server VM (build 25.201-b09, mixed mode)

If you don’t see similar output on your machine, see Oracle’s web site for Java JDK downloads.

  1. Download the DEB file:

    Click the Deb package button.

  2. Use a terminal to install the DEB file:

    sudo dpkg -i /faunadb-enterprise-2.7.0-0.deb
    If you have downloaded a version of FaunaDB that is newer than these instructions, update the version number in the above command before executing it.

    If you prefer to use apt, you need to add the Fauna repository:

    echo "deb [arch=all] https://repo.fauna.com/debian stable non-free" | sudo tee /etc/apt/sources.list.d/faunadb.list
    sudo apt-get update
    sudo apt-get install faunadb

    Using either dpkg or apt installs FaunaDB and creates a faunadb user on your machine.

  3. Create a configuration file:

    Copy the following YAML configuration into the file /etc/faunadb.yml:

    ---
    auth_root_key: secret
    cluster_name: fauna
    replica_name: replica
    network_listen_address: 127.0.0.1
    network_broadcast_address: 127.0.0.1
    network_admin_http_address: 127.0.0.1
    network_coordinator_http_address: 127.0.0.1
  4. Start a node:

    sudo systemctl start faunadb-enterprise
  5. Verify that the node is running:

    sudo systemctl status faunadb
    
    faunadb-enterprise.service - FaunaDB Enterprise Edition
       Loaded: loaded (/usr/lib/systemd/system/faunadb.service; disabled; vendor preset: disabled)
       Active: active (running) since Thu 2019-06-27 12:00:38 PDT; 17s ago
      Process: 1311 ExecStartPre=/bin/chmod 755 /run/faunadb (code=exited, status=0/SUCCESS)
      Process: 1309 ExecStartPre=/bin/chown faunadb:faunadb /run/faunadb (code=exited, status=0/SUCCESS)
      Process: 1307 ExecStartPre=/bin/mkdir -p /run/faunadb (code=exited, status=0/SUCCESS)
     Main PID: 1313 (java)
       CGroup: /system.slice/faunadb.service
               └─1313 java -Djava.net.preferIPv4Stack=true -Dhttp.connection.timeout=2 -Dhttp.connection-manager.timeout=2 -Dhttp.socket.timeout=6 -Xmx249714K -Xms249714K -Xss256k -Xloggc:/var/log/faunadb/gc.log -XX:+UseG1GC -XX:MaxGCPauseMillis=200 ...
    
    Thu 27 12:00:41 localhost.localdomain faunadb[1313]: Loaded configuration from /etc/faunadb.yml...
    Thu 27 12:00:42 localhost.localdomain faunadb[1313]: Network Host ID: 127.0.0.1
    Thu 27 12:00:42 localhost.localdomain faunadb[1313]: Cluster name: fauna
    Thu 27 12:00:47 localhost.localdomain faunadb[1313]: Data path: /var/lib/faunadb
    Thu 27 12:00:47 localhost.localdomain faunadb[1313]: Temp path: /var/lib/faunadb/tmp
    Thu 27 12:00:47 localhost.localdomain faunadb[1313]: Snapshot path: /var/lib/faunadb/snapshots
    Thu 27 12:00:48 localhost.localdomain faunadb[1313]: Admin endpoint: 127.0.0.1:8444
    Thu 27 12:00:48 localhost.localdomain faunadb[1313]: API endpoint: 127.0.0.1:8443
    Thu 27 12:00:48 localhost.localdomain faunadb[1313]: FaunaDB is ready.

    If you see output similar to the above, FaunaDB has started successfully and is using the configuration that we specified.

    If this is the first time that you are running FaunaDB, internal data structures need to be initialized with the following command:

    faunadb-admin init
    
    Loaded configuration from /etc/faunadb.yml...
    Node has initialized the cluster.
  6. Confirm that the node is running:

    curl http://172.17.0.2:8443/ping
    { "resource": "Scope write is OK" }
Single nodes, for development or testing, are free to use indefinitely. Clusters involving 2 or more nodes are free to use for 90 days. For more information, see our Pricing page.

Was this article helpful?

We're sorry to hear that.
Tell us how we can improve! documentation@fauna.com

Thank you for your feedback!