Getting Started with ArangoDB Oasis

The instructions below are a quick start guide on how to set up your first ArangoDB deployment in Oasis. It covers everything from creating an account to using the Oasis web interface to set up a test organization, project and deployment, as well as accessing and deleting the deployment.

For general information about ArangoDB Oasis, see

A video series on how to get started with Oasis is also available:


Please have following information at hand for registration:

  • An email address, required for email verification.

If you use a public email service provider (e.g. Hotmail), make sure to have the following information at hand as well:

  • A mobile phone number, required for SMS verification

One mobile phone number will be associated with one account and cannot be used for multiple accounts.

Creating a new account

  1. Go to
  2. To reach the sign up, press the Sign to get started button or click the Sign Up link in the header navigation of the start page.
  3. Review the terms &amp conditions and privacy policy and click I accept. You’re now send to the sign up page.
  4. Select the type of sign up you would like to use (GitHub, Google, or email address).
    • For GitHub or Google please follow on-screen instructions.
    • For the email address option, type your desired email address in the email field and type a strong password in the password field.
    • Press the Sign up button

    You will receive a verification email. In that mail, press the Verify my email address link or button.

  5. You will open a page in ArangoDB Oasis that says Welcome back! Click the Log in button to continue and login.
  6. If you signed up with an email address of a public email service provider (e.g. Hotmail), a form appears asking for your mobile phone number. Enter the country code and the number of the mobile phone you want to use for this account. For company email addresses, this step is skipped.
  7. If you had to enter your phone number in the previous step, a verification code will be sent via SMS to the mobile number you entered. Enter the verification code.
  8. A form will appear asking for your name. Enter your first, last and company name, and then press the Save button.
  9. An organization with a default project will now be prepared for you. Once that is completed, you will be redirected to the ArangoDB Oasis dashboard.

General hierarchy

Organizations → Projects → Deployments

  • ArangoDB Oasis supports multi-tenant setups via organizations.
  • You can create your own organization(s) and invite collaborators or join existing ones via invites.
  • Your organization contains projects.
  • Your projects hold your deployments.

Also see the Project Guide.

Creating a new project

A default project is automatically created for you. You can skip this paragraph unless you want to add additional projects.

  1. In the main navigation, in the Projects section, click the Overview link.
  2. Click the New project button.
  3. Enter a name and optional description for your new project.
  4. Click the Create button.
  5. You will now be taken to the project summary page.

Oasis New Project

Also see the video Projects with ArangoDB Oasis.

Creating a new deployment

  1. If you don’t have a project, yet, create one first.
  2. In the main navigation, in the Projects section, click on the project for which you want to create a new deployment.
  3. Navigate to the Deployments tab. You will see an empty list or a list with your project’s deployments.
  4. Press the New deployment button.

Oasis Deployments

Also see the video Create a Deployment on ArangoDB Oasis.

In the General section

  • Enter the name and optional short description for the deployment.

In the Location section

  1. Select the Provider and Region of the provider.
  2. Select the DB Version. Note: If you don’t know which DB version to select, leave the version selected by default.
  3. In the CA Certificate field
    • The default certificate created for your project will automatically be selected.
    • If you have no default certificate, or want to use a new certificate create a new certificate by typing the desired name for it and hitting enter or clicking on the name when done.
    • Or, if you already have multiple certificates, select the desired one.
  4. Optional but strongly recommended: In the IP whitelist field, select the desired one in case you want to limit access to your deployment to certain IP ranges. To create a whitelist, navigate to your project and select the IP whitelists tab (also see the video IP Whitelists with ArangoDB Oasis).

For any kind of production deployment we strongly advise to use an IP whitelist.

Oasis New Deployment

In the Configuration section

Choose between a OneShard and Sharded deployment.

OneShard deployments are suitable when your data set fits in a single node. They are ideal for graph use cases.

Sharded deployments are suitable when your data set is larger than a single node. The data will be sharded across multiple nodes.


  1. Select the memory size of your node.
  2. Select the CPU size of your node.
  3. Select the disk size of your node. The available ranges for the disk size depend on the selected memory size.

Oasis Deployment OneShard


  • In addition to memory and disk size as in the OneShard configuration, select the number of nodes for your deployment. The more nodes you have, the higher the replication factor.

Oasis Deployment Sharded

  • If you’re unsure about the sharded setup, you can go through our wizard. Click on Help me decide to open the recommendation process.

Oasis Deployment Sharded

  • The wizard will guide you through a set of questions and display a recommendation.
  • Click Use recommendation to apply it to your sharded configuration.

In the Summary section

  1. Review the configuration, and if you’re ok with the setup press the Create button.
  2. You will be taken to the deployment overview page. Note: Your deployment is at that point being bootstrapped, this process will take a few minutes. Once it is ready, you will receive a confirmation email.

Installing a new certificate

Certificates that do have the Use well known certificate option enabled do not need any installation and will be supported by almost all web-browsers automatically.

Each certificate you create in ArangoDB Oasis that has the Use well known certificate option disabled, you will also need to install on your local machine. This operation will slightly vary between operating systems.

  1. In the main navigation, in the Projects section, click on the project for which you want to install a new certificate.
  2. Navigate to the Certificates tab.

    Oasis Certificates

  3. From the list of certificates, click on the one you want to install.
  4. Navigate to the tab of the operating system of your choice.
  5. Under Installation instructions, copy the commands by pressing the Copy to clipboard button.

    Oasis Certificate Install Instructions

  6. Open a console on your local computer and run the commands that are provided.

Also see the video Certificates with ArangoDB Oasis.

Accessing your deployment

  1. In the main navigation, in the Projects section, click on the project for which you created a deployment earlier.
  2. Navigate to the Deployments tab.
  3. For each deployment in your project, you see the status. While your new deployment is being set up, it will display the bootstrapping status.
  4. Press the View button to show the deployment page.
  5. When a deployment displays a status of OK, you can access it.
  6. Click the copy icon next to the root password. This will copy the deployment root password to your clipboard. You can also click the view icon to unmask the root password to see it.
  7. You will also receive an email that the deployment is available, with a URL to open it up.
  8. Click on the Open endpoint button or on the endpoint URL property to open the dashboard of your new ArangoDB deployment.
  9. In the username field type root, and in the password field paste the password that you copied earlier.
  10. Press the Login button.
  11. Press the Select DB: _system button

At this point your ArangoDB deployment is available for you to use — Have fun!

Each deployment is accessible on two ports:

  • Port 8529 is the standard port recommended for use by web-browsers.
  • Port 18529 is the alternate port that is recommended for use by automated services.

The difference between these ports is the certificate used. If you enable Use well known certificate, the certificates used on port 8529 is well known and automatically accepted by most web browsers. The certificate used on port 18529 is a self-signed certificate. For securing automated services, the use of a self-signed certificate is recommended.

Deleting your deployment

This operation cannot be undone and all deployment data will be lost, please proceed with caution.

  1. In the main navigation, in the Projects section, click on the project that holds the deployment you wish to delete.
  2. Navigate to the Deployments tab.
  3. Click on the deployment you wish to delete.
  4. Navigate to the Danger zone tab.
  5. Press the Delete deployment button.
  6. In the modal dialog, confirm the deletion by entering Delete! into the designated text field.
  7. Start the deletion by pressing the Yes button.
  8. You will be taken back to the deployments page of the project. The deployment being deleted will display the Deleting status until it has been successfully removed.

Free-to-try vs. professional service

ArangoDB Oasis comes with a free-to-try plan that lets you test our ArangoDB Cloud for free for 14 days. After the trial period, your deployments will automatically be deleted.

You can convert to the professional service model at any time by adding your billing details and at least one payment method.

Adding billing details

  1. In the main navigation, in the Organization section, click the Overview link.
  2. Navigate to the Billing tab.
  3. In the Billing details section, click the Edit button.
  4. Enter your billing address and EU VAT identification number, if applicable.
  5. Optionally, enter the email address(es) to which invoices should be emailed automatically

Oasis Billing Details

Adding a payment method

  1. In the Payment methods section, click the Add button.
  2. From the dropdown, select a payment type (currently, only credit card is supported).
  3. Enter your credit card details in the form.
  4. Click the Save button.

Oasis Payment Method

Limitations of ArangoDB Oasis

ArangoDB Oasis aims to make all features of the ArangoDB Enterprise Edition available to you, but there are a few limitations:

  1. Encryption (both at rest & network traffic) is always on and cannot be disabled for security reasons.
  2. Foxx services are not allowed to call out to the internet for security reasons. Incoming calls to Foxx services are fully supported.
  3. LDAP authentication & Audit trails are currently unavailable, but will be supported in the near future.