FaunaDB has been available as a managed cloud database since March. We’re seeing tremendous interest in and adoption of our cloud service, but we’ve also gotten many requests to make FaunaDB available for download. Sometimes it’s just easier to work against a local instance of your database.

That’s why we’re excited to announce that you can begin developing against FaunaDB on your laptop today. We are releasing a preview version of FaunaDB Developer Edition that you can download simply by creating a FaunaDB account. FaunaDB Developer Edition is a single-node, plug-and-play version of FaunaDB. It requires no installation or configuration, and is ideal for local development and testing.

FaunaDB Developer Edition is free but limited—you can’t set up a distributed cluster with it, and it’s not tuned for high performance. But you can start developing against FaunaDB on your workstation today, and we look forward to incorporating your feedback into the enterprise build.

It’s easy to install since it’s packaged as a single Java JAR and has no service or library dependencies aside from a recent JVM.

Up and Running

You can download, install, and initialize FaunaDB in about 5 minutes. You will need to do the following:

  1. Make sure Java 8 is installed on your machine.
  2. Download FaunaDB Developer Edition preview.
  3. Extract faunadb-developer.jar from the ZIP file.
  4. In the directory where you extracted the JAR, run: $ java -jar faunadb-developer.jar

You’ll see the following:

   ____                    ___  ___
  / __/__ ___ _____  ___ _/ _ \/ _ )
 / _// _ `/ // / _ \/ _ `/ // / _  |
/_/  \_,_/\_,_/_//_/\_,_/____/____/
                        
Starting FaunaDB Developer Edition 2.2.0-8d3631a
Data path: ./data
API address: 0.0.0.0
API port: 8443
FaunaDB is ready.

Now you’re ready to start working with FaunaDB’s query semantics in your favorite programming language. Your application interacts with FaunaDB through a language-specific driver, so you’ll never need to learn a new query language to use all the features of FaunaDB. Download a native driver from our resources page.

Once you’ve downloaded your driver, use our Hello World tutorial to install your driver and try your very first query.

Our tutorials are written to connect to FaunaDB Serverless Cloud, and all drivers are configured to communicate with FaunaDB Serverless Cloud by default. Configuring the driver to talk to your local installation of FaunaDB means overriding some defaults. Here is an example of what that looks like in JavaScript. You should make sure the address and port match what was printed when you launched the database.

var client = new faunadb.Client({
  secret: "secret",
  scheme: 'http',
  domain: '127.0.0.1',
  port: 8443
})

Here is the complete runnable example in JavaScript, and configuring clients in the other languages works along the same lines. If you want to allow only local connections, you should launch the developer jar with a custom configuration file to bind it to a private interface and set a custom root secret.

If you run into issues, we can help you on Stack Overflow.

Onward

The full FaunaDB Developer Edition is planned for release in the fall. Between now and then, we’re focusing on query language improvements (always backwards compatible!), samples, documentation, and other tools, so that FaunaDB’s sweet spot of mixed document, relational, and graph use cases gets even easier for developers to use.

We’ve built our communication and support tools directly into the dashboard so that you get help from our team with minimal friction. When your organization is ready to begin a strategic project, we’re happy to set up dedicated channels to support your work.

In the meantime, happy coding!

  1. Read our White Paper

    Explore the motivations and technical design of FaunaDB in our white paper.

    Get the White Paper

Stay up to date with Fauna

Subscribe to our Blog and get notifications when we publish new content.

Successfully registered your email. Stay tuned for more updates from Fauna!