surrealdb/surrealdb

is the ultimate cloud <br> database for tomorrow's applications

Develop easier.   Build faster.   Scale quicker.

https://github.com/surrealdb/surrealdb   https://github.com/surrealdb/surrealdb   https://github.com/surrealdb/surrealdb/actions 

 
https://hub.docker.com/repository/docker/surrealdb/surrealdb
 
https://github.com/surrealdb/license

 

 

 

 
https://github.com/surrealdb/surrealdb
 

 

 

 

 

 
https://stackoverflow.com/questions/tagged/surrealdb

  What is SurrealDB?

SurrealDB is an end-to-end cloud native database for web, mobile, serverless, jamstack, backend, and traditional applications. SurrealDB reduces the development time of modern applications by simplifying your database and API stack, removing the need for most server-side components, allowing you to build secure, performant apps quicker and cheaper. SurrealDB acts as both a database and a modern, realtime, collaborative API backend layer. SurrealDB can run as a single server or in a highly-available, highly-scalable distributed mode - with support for SQL querying from client devices, GraphQL, ACID transactions, WebSocket connections, structured and unstructured data, graph querying, full-text indexing, geospatial querying, and row-by-row permissions-based access.

View the features, the latest releases, the product roadmap, and documentation.

  Documentation

For guidance on installation, development, deployment, and administration, see our documentation.

  Run using Docker

Docker can be used to manage and run SurrealDB database instances without the need to install any command-line tools. The SurrealDB docker container contains the full command-line tools for importing and exporting data from a running server, or for running a server itself.

bash
docker run --rm --pull always --name surrealdb -p 8000:8000 surrealdb/surrealdb:latest start

For just getting started with a development server running in memory, you can pass the container a basic initialization to set the user and password as root and enable logging.

bash
docker run --rm --pull always --name surrealdb -p 8000:8000 surrealdb/surrealdb:latest start --log trace --user root --pass root memory

Access to the surrealdb CLI with:

bash
docker exec -it <container_name> /surreal sql -c http://localhost:8000 -u root -p root --ns test --db test --pretty

  Run using Docker Compose

The Docker image can be used with the docker-compose tool. It is possible to override the entrypoint to ask it to use the start command. Here is an exemple of docker-compose.yml file.

yaml
version: '3'

services:
  surrealdb:
    env_file:
      - .env
    entrypoint: 
      - /surreal 
      - start 
      - --user
      - $DB_USER
      - --pass
      - $DB_PASSWORD
    image: surrealdb/surrealdb:latest
    ports:
      - 8000:8000

  Community

Join our growing community around the world, for help, ideas, and discussions regarding SurrealDB.

• View our official Blog
• Chat live with us on ***
• Follow us on ***
• Connect with us on LinkedIn
• Visit us on ***
• Join our Dev community
• Questions tagged #surrealdb on https://stackoverflow.com/questions/tagged/surrealdb

  Contributing

We would    for you to get involved with SurrealDB development! If you wish to help, you can learn more about how you can contribute to this project in the contribution guide.

  Security

For security issues, view our https://github.com/surrealdb/surrealdb/security/policy, view our security policy, and kindly email us at *** instead of posting a public issue on GitHub.

  License

Source code for SurrealDB is variously licensed under a number of different licenses. A copy of each license can be found in https://github.com/surrealdb.

• Libraries and SDKs, each located in its own distinct repository, are released under either the https://github.com/surrealdb/license/blob/main/APL.txt or https://github.com/surrealdb/license/blob/main/MIT.txt.
• Certain core database components, each located in its own distinct repository, are released under the https://github.com/surrealdb/license/blob/main/APL.txt.
• Core database code for SurrealDB, located in https://github.com/surrealdb/surrealdb, is released under the Business Source License 1.1.

For more information, see the https://github.com/surrealdb/license.