Use ArangoDB in the Cloud

This quick start guide covers the basics from creating an Oasis account to setting up and accessing your first ArangoDB cloud deployment

For general information about ArangoDB Oasis, see cloud.arangodb.com.

For guides and reference documentation, see the Oasis documentation.

Prerequisites

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.

How to Create a New Account

  1. Go to cloud.arangodb.com.
  2. Click the Start Free button or click the Sign Up link in the top right corner.

    Oasis Homepage

  3. Review the terms & conditions and privacy policy and click I accept.
  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.

    Oasis Sign up

    Click the Sign up button. You will receive a verification email. In that mail, click the Verify my email address link or button. It opens a page in ArangoDB Oasis that says Welcome back!

  5. 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 is sent via SMS to the mobile number you entered. Enter the verification code.
  8. Fill out a form with your first and last name, and company name, and then press the Save button.
  9. An organization with a default project is now prepared for you. Once that is completed, you will be redirected to the ArangoDB Oasis dashboard.

Get a Deployment up and Running

  1. The first card in the Oasis Dashboard has a dropdown menu to select a cloud provider and region. Pick one, click Create deployment and accept the terms and conditions.

    Oasis Dashboard

    You can also create a deployment manually, if you want fine-grained configuration options.

  2. The new deployment is displayed in the list of deployments for the respective project (here: Avocado).

    Oasis Deployments Bootstrapping

    It takes a couple of minutes before the deployment can be used. The status is changed from Bootstrapping to OK eventually and you also receive an email when it is ready.

    Oasis Deployment Ready Email

  3. Click the name or the View button of the deployment card (or the Open deployment details link in the email) to view the deployment details.

    Oasis Deployment Ready

  4. You can copy the ArangoDB password for the root user by clicking the second button below the label ROOT PASSWORD. Then click the Open endpoint button to open the ArangoDB web interface. Enter the credentials (user root and its password) and log in.

  5. You can install example datasets and follow the accompanying guides to get started with ArangoDB and its query language. In the Oasis dashboard, click the Examples tab of the deployment. Click Install for one of the examples to let Oasis create a separate database and import the dataset. Click Guide for instructions on how to access and run queries against this data.

    Oasis Deployment Examples

    Oasis Deployment Examples IMDB Guide

General Hierarchy

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.

  • Organizations represent (commercial) entities such as companies. You can be part of multiple organizations with a single user account.
    • Projects represent organizational units such as teams or applications.
      • Deployments are the actual instances of ArangoDB clusters.

When you sign up for Oasis, an organization and a default project are automatically created for you. What is still missing is a deployment.

Take the Tour

In the top right corner you find the User toolbar. Click the icon with the question mark to bring up the help menu and choose Start tour. This guided tour walks you through the creation of a deployment and shows you how to load example datasets and manage projects and deployments.

Start tour in menu

Alternatively, follow the steps of the linked guides:

Free-to-Try vs. Professional Service

ArangoDB Oasis comes with a free-to-try tier that lets you test our ArangoDB Cloud for free for 14 days. It includes one project and one deployment. After the trial period, your deployments are automatically deleted.

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

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:

  • Encryption (both at rest & network traffic) is always on and cannot be disabled for security reasons.
  • Foxx services are not allowed to call out to the internet by default for security reasons, but can be enabled on request. Incoming calls to Foxx services are fully supported.
  • LDAP authentication is currently in a testing phase.
  • Datacenter to Datacenter Replication (DC2DC) is not yet available in a managed form.