SurrealDB Docs Logo

Enter a search query

Frequently asked questions

If you have questions about Surreal Cloud (Beta), you can find answers on this page. This document provides a comprehensive understanding of Surreal Cloud (Beta), whether you are a beginner getting started with Surreal Cloud (Beta) or an experienced user looking for specific information.

General questions

What is Surreal Cloud (Beta)?

Surreal Cloud (Beta) offers the power and flexibility of SurrealDB without the pain of managing infrastructure. We take care of managing and operating the underlying infrastructure so that you can focus on what you do best-building great applications for your customers.

How do I get started with Surreal Cloud (Beta)?

Getting started is easy. Sign up for an account on Surrealist. Once registered, you can access the dashboard, choose services, and start building with Surreal Cloud (Beta) immediately.

Are there self-help resources like documentation or tutorials available?

Yes. We have a resource hub with all our latest documentation. We also recommend our YouTube channel where you can find easy-to-follow tutorials, and content from our Community.

What kind of support is available at the launch of Surreal Cloud (Beta)?

We are offering community support at launch. You can get help via our Discord channel #surreal-cloud or any of our community channels.

Which cloud platform is SurrealDB available on?

At present, SurrealDB is available on AWS. In the future we plan to expand to other cloud platforms.

My current application is on SurrealDB. Can I move this to Surreal Cloud (Beta)?

Yes. You can move your current application built in SurrealDB to Surreal Cloud (Beta). You can find more information in the migrate your existing data documentation.

How do I migrate my existing on-premises instance to Surreal Cloud (Beta)?

We are working on a migration tool to help you move your existing on-premises instance to Surreal Cloud (Beta). In the meantime, you can use the import and export commands to move data between your on-premises instance and Surreal Cloud (Beta).

What programming languages are supported?

Surreal Cloud (Beta) supports the following programming languages:

Why am I getting an authentication error connecting via SDK?

You need to create a User first. Head to the connect via SDK documentation for more details.

How do I backup my data?

Currently, you can not backup your data with Surreal Cloud (Beta). However, you can use the export command to backup your data via the SurrealDB CLI.

What are the limits of the Surreal Cloud (Beta)?

It is not currently possible to configure CLI arguments or environment variables in Surreal Cloud (Beta).

Surreal Cloud (Beta) nodes run with the default SurrealDB capabilities except for allowing network access to the Cloud API for the purposes of authenticating with Surrealist.

Surreal Cloud (Beta) does not currently allow outgoing network requests, scripting, or guest access. All functions, RPC methods and all HTTP routes are allowed.

GraphQL support is not yet enabled on Surreal Cloud (Beta) instances.

Note

Free Tier instances surpassing the 1GB free storage allowance will be limited to data retrieval only. Unless you upgrade to a paid tier, you will not be able to create new data.

Security

How secure is Surreal Cloud (Beta)?

Surreal Cloud (Beta) is designed with security in mind and aims to provide robust protection for your data and applications. The platform leverages industry-standard security practices, including encryption at rest and in transit, network isolation, access controls and monitoring. For authentication, Surreal Cloud (Beta) supports multi-factor authentication through the available identity providers that offer it to their users. We are also working towards ISO 27001 and SOC 2 compliance, with plans to expand to other industry-specific compliance programs in the future, such as HIPAA or PCI DSS.

Additionally, Surreal Cloud (Beta) is built on top of SurrealDB, which provides powerful and flexible security features that are available to all Surreal Cloud (Beta) customers. SurrealDB is developed and maintained following modern security practices to ensure early detection of security vulnerabilities and other security issues.

Please note that we will keep improving security during the ongoing beta stage and, as a precaution, we recommend abstaining from hosting sensitive data in Surreal Cloud (Beta) during this stage.

How can I report a security issue in Surreal Cloud (Beta)?

If you believe you have found a security vulnerability in Surreal Cloud (Beta) or SurrealDB, we encourage you to let us know right away. We will investigate all legitimate reports and do our best to quickly address the issue. Please report any security issue to security@surrealdb.com. For security issues in SurrealDB, please submit a report via Github Security Advisories rather than posting a public issue in GitHub.

We ask that you…

  • … privately disclose the details of any potential vulnerability to SurrealDB.
  • … provide enough information to reproduce the vulnerability in your report.

We ask that you refrain from…

  • … disclosing the details of a vulnerability publicly or to third parties.
  • … exploiting a vulnerability beyond what is strictly necessary to verify its existence.
  • … running automated security tools against SurrealDB infrastructure without permission.

We commit to…

  • … acknowledging your report within three business days of the date of communication.
  • … verifying the issue and keeping you informed of the progress toward its resolution.
  • … handling your report and any data you share with us with strict confidentiality.
  • … abstaining from legal action against you for any report made following this policy.
  • … crediting you in any relevant public security advisory unless you desire otherwise.

How do I configure user authentication?

Surreal Cloud allows users to authenticate directly into their instances from Surrealist using a pre-defined access method. Once connected to your Instance, you may define users or access methods that users can use to access your Instance or specific namespaces or databases using any of the available interfaces, the SurrealDB CLI or Surrealist.

Can I use my own encryption keys?

Currently, any encryption keys used to encrypt data at rest are managed by Surreal Cloud. Since the architecture technically supports it, we may consider allowing customers to associate their own Customer-Managed Encryption Keys (CMEK) to be used to encrypt data at rest in the future. If you are interested in CMEK, please, contact us.

Can I limit who can reach my instances over the internet?

All instances created in Surreal Cloud are publicly reachable over the internet and currently rely exclusively on the authentication and authorization mechanisms that are defined within the instance to prevent access to their data. We plan on providing the ability to restrict network access to instances as well as the ability to limit the capabilities of each instance in the future. If your use case requires private network access to the instances, please, contact us.

Pricing

How much does Surreal Cloud (Beta) cost?

Surreal Cloud (Beta) offers a flexible pricing model that allows you to pay only for the resources you use. The pricing is based on storage and compute you consume. For detailed pricing information, please refer to the pricing page.

Is there a free tier available for Surreal Cloud (Beta)?

Yes, Surreal Cloud (Beta) offers a free tier that allows you to get started with the platform at no cost. The free tier provides limited resources for development and testing purposes, enabling you to explore the features and capabilities of Surreal Cloud (Beta) without incurring any charges.

I am on the free tier. Can I add another cluster?

Anyone using the Individual (free) tier wishing to add another cluster will be alerted in their account that they must fill in their billing information.

What pricing models are available?

At launch, we will offer a free and a paid tier. We are working on our future offerings.

Will SurrealDB provide itemised invoices with tax identified?

Yes. Customers with a VAT or tax identification number, should insert this in the billing section of their customer profile.

Who do I contact for billing queries or account issues?

Please send an email to support@surrealdb.com outlining the nature of your query and we will help you.

Are there any additional fees?

No, we are transparent about our pricing. All costs are outlined on our pricing page, and there are no hidden fees or unexpected charges. Prices quoted on our website are exclusive of VAT or sales tax. Any relevant taxes will be displayed clearly on all customer invoices.

How am I billed for usage?

You are billed on a monthly basis for all services used during the previous month. The billing cycle starts on the first day of each month and ends on the last day. You will receive an invoice via email.

What terms and conditions govern my use of Surreal Cloud (Beta)?

Using Surreal Cloud (Beta) means that the User agrees to the terms and conditions of our Master Services Agreement (MSA) available on our legal page. Here we endeavour to be open and transparent with our legal, compliance, and privacy processes and our shared responsibilities and commitments to supporting your use of the Services.

Are you located in a US-Embargoed country or in Russia?

SurrealDB Inc., complies with U.S. regulations related to embargoed countries and regions. As such, SurrealDB currently prohibits use of its products and services in Cuba, Iran, North Korea, Syria, and the regions of Crimea, Luhansk People’s Republic (LNR), and Donetsk People’s Republic (DNR). SurrealDB uses geoblocker software to prevent logins from these restricted countries however, regional blocks may mean that an entire country is restricted from using our services. This is beyond our direct control.

Additionally, Surreal DB Ltd is subject to Article 5n(2b) of Council Regulation 833/2014 in which it is prohibited to sell, supply, transfer, export, or provide, directly or indirectly, software for the management of enterprises and software for design and manufacture, to the Government of Russia or to legal persons, entities or bodies established in Russia. SurrealDB takes its compliance obligations very seriously and will update them as needed from time to time.

Troubleshooting and Support

What should I do if I cannot connect to Surreal Cloud (Beta)?

If you are unable to connect to Surreal Cloud (Beta), please check the following:

  • Ensure that your network connection is stable and that you have internet access.
  • Verify that your credentials are correct and that you have the necessary permissions to access Surreal Cloud (Beta).
  • Check the status of the Surreal Cloud (Beta) service to see if there are any ongoing issues or maintenance activities.
  • If you are still unable to connect, please contact Surreal Cloud (Beta) support for further assistance.

Where can I find further documentation or tutorials?

You can find a variety of resources to help you learn more about SurrealDB via our website including:

  • SurrealDB Docs: Comprehensive guides and references for all features, including docs to accompany Surrealist
  • YouTube Channel: Stay up-to-date with the latest releases, learn new skills and discover what other developers are building with SurrealDB.
  • SurrealDB University: A self-paced video course with hands-on labs and interactive tutorials.
  • SurrealDB Book: An in-depth, story-driven guide to mastering SurrealDB.

How do I report a bug or request a feature in Surreal Cloud (Beta)?

If you encounter a bug or have a feature request for Surreal Cloud (Beta), you can report it through the support portal or contact the Surreal Cloud (Beta) team directly. Please provide detailed information about the issue or feature request, including steps to reproduce the problem, screenshots, and any other relevant details. The Surreal Cloud (Beta) team will review your submission and work to address the issue or implement the feature in a future release.

On this page

© SurrealDB GitHub Discord Community Cloud Features Releases Install