{"id":13423425,"url":"https://github.com/surrealdb/surrealdb","last_synced_at":"2026-07-06T17:00:26.637Z","repository":{"id":37254102,"uuid":"436658287","full_name":"surrealdb/surrealdb","owner":"surrealdb","description":"A scalable, distributed, collaborative, document-graph database, for the realtime web","archived":false,"fork":false,"pushed_at":"2026-06-17T17:21:39.000Z","size":57358,"stargazers_count":32412,"open_issues_count":666,"forks_count":1271,"subscribers_count":160,"default_branch":"main","last_synced_at":"2026-06-18T16:31:21.518Z","etag":null,"topics":["backend-as-a-service","cloud-database","database","database-as-a-service","developer-tools","devtools","distributed","distributed-database","document-database","graph-database","iot-database","nosql","realtime-database","serverless","sql","surreal","surrealdb","web"],"latest_commit_sha":null,"homepage":"https://surrealdb.com","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/surrealdb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-12-09T15:03:29.000Z","updated_at":"2026-06-18T12:40:07.000Z","dependencies_parsed_at":"2023-10-23T10:33:35.870Z","dependency_job_id":null,"html_url":"https://github.com/surrealdb/surrealdb","commit_stats":{"total_commits":2190,"total_committers":54,"mean_commits":40.55555555555556,"dds":"0.11689497716894981","last_synced_commit":"e6b97ff8ff0760a7897366a21aba36fae15be35e"},"previous_names":[],"tags_count":168,"template":false,"template_full_name":null,"purl":"pkg:github/surrealdb/surrealdb","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/surrealdb%2Fsurrealdb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/surrealdb%2Fsurrealdb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/surrealdb%2Fsurrealdb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/surrealdb%2Fsurrealdb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/surrealdb","download_url":"https://codeload.github.com/surrealdb/surrealdb/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/surrealdb%2Fsurrealdb/sbom","scorecard":{"id":1241955,"data":{"date":"2026-01-18T09:48:27Z","repo":{"name":"github.com/surrealdb/surrealdb","commit":"422f790fc045ef8893be618737a8d7705d4f8e1b"},"scorecard":{"version":"v5.1.1","commit":"cd152cb6742c5b8f2f3d2b5193b41d9c50905198"},"score":7.2,"checks":[{"name":"Security-Policy","score":10,"reason":"security policy file detected","details":["Info: security policy file detected: SECURITY.md:1","Info: Found linked content: SECURITY.md:1","Info: Found disclosure, vulnerability, and/or timelines in security policy: SECURITY.md:1","Info: Found text in security policy: SECURITY.md:1"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/cd152cb6742c5b8f2f3d2b5193b41d9c50905198/docs/checks.md#security-policy"}},{"name":"Code-Review","score":10,"reason":"all changesets reviewed","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/cd152cb6742c5b8f2f3d2b5193b41d9c50905198/docs/checks.md#code-review"}},{"name":"Dependency-Update-Tool","score":10,"reason":"update tool detected","details":["Info: detected update tool: Dependabot: .github/dependabot.yml:1"],"documentation":{"short":"Determines if the project uses a dependency update tool.","url":"https://github.com/ossf/scorecard/blob/cd152cb6742c5b8f2f3d2b5193b41d9c50905198/docs/checks.md#dependency-update-tool"}},{"name":"Maintained","score":10,"reason":"30 commit(s) and 2 issue activity found in the last 90 days -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/cd152cb6742c5b8f2f3d2b5193b41d9c50905198/docs/checks.md#maintained"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/cd152cb6742c5b8f2f3d2b5193b41d9c50905198/docs/checks.md#packaging"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Info: jobLevel 'contents' permission set to 'read': .github/workflows/bench.yml:104","Info: jobLevel 'packages' permission set to 'read': .github/workflows/codeql.yml:41","Info: jobLevel 'actions' permission set to 'read': .github/workflows/codeql.yml:43","Info: jobLevel 'contents' permission set to 'read': .github/workflows/codeql.yml:44","Warn: jobLevel 'contents' permission set to 'write': .github/workflows/release.yml:436","Info: topLevel permissions set to 'read-all': .github/workflows/automoderator.yaml:7","Info: topLevel 'contents' permission set to 'read': .github/workflows/bench.yml:35","Info: topLevel 'contents' permission set to 'read': .github/workflows/ci.yml:29","Info: topLevel 'contents' permission set to 'read': .github/workflows/codeql.yml:29","Info: topLevel permissions set to 'read-all': .github/workflows/community-pr-label.yml:19","Info: topLevel 'contents' permission set to 'read': .github/workflows/coverage.yml:17","Info: topLevel 'contents' permission set to 'read': .github/workflows/fuzzing.yml:16","Info: topLevel 'contents' permission set to 'read': .github/workflows/labeler.yml:9","Info: topLevel 'contents' permission set to 'read': .github/workflows/nix.yml:16","Warn: topLevel 'contents' permission set to 'write': .github/workflows/release.yml:70","Info: topLevel permissions set to 'read-all': .github/workflows/scorecard.yml:18","Info: topLevel 'contents' permission set to 'read': .github/workflows/supply-chain.yml:49"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/cd152cb6742c5b8f2f3d2b5193b41d9c50905198/docs/checks.md#token-permissions"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/cd152cb6742c5b8f2f3d2b5193b41d9c50905198/docs/checks.md#dangerous-workflow"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/cd152cb6742c5b8f2f3d2b5193b41d9c50905198/docs/checks.md#binary-artifacts"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v3.0.0-beta.2 not signed: https://api.github.com/repos/surrealdb/surrealdb/releases/277546099","Warn: release artifact v2.4.1 not signed: https://api.github.com/repos/surrealdb/surrealdb/releases/275206956","Warn: release artifact v3.0.0-beta.1 not signed: https://api.github.com/repos/surrealdb/surrealdb/releases/271174356","Warn: release artifact v3.0.0-alpha.18 not signed: https://api.github.com/repos/surrealdb/surrealdb/releases/270451093","Warn: release artifact v3.0.0-alpha.17 not signed: https://api.github.com/repos/surrealdb/surrealdb/releases/267819123","Warn: release artifact v3.0.0-beta.2 does not have provenance: https://api.github.com/repos/surrealdb/surrealdb/releases/277546099","Warn: release artifact v2.4.1 does not have provenance: https://api.github.com/repos/surrealdb/surrealdb/releases/275206956","Warn: release artifact v3.0.0-beta.1 does not have provenance: https://api.github.com/repos/surrealdb/surrealdb/releases/271174356","Warn: release artifact v3.0.0-alpha.18 does not have provenance: https://api.github.com/repos/surrealdb/surrealdb/releases/270451093","Warn: release artifact v3.0.0-alpha.17 does not have provenance: https://api.github.com/repos/surrealdb/surrealdb/releases/267819123"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/cd152cb6742c5b8f2f3d2b5193b41d9c50905198/docs/checks.md#signed-releases"}},{"name":"CII-Best-Practices","score":2,"reason":"badge detected: InProgress","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/cd152cb6742c5b8f2f3d2b5193b41d9c50905198/docs/checks.md#cii-best-practices"}},{"name":"License","score":9,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Warn: project license file does not contain an FSF or OSI license."],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/cd152cb6742c5b8f2f3d2b5193b41d9c50905198/docs/checks.md#license"}},{"name":"Pinned-Dependencies","score":6,"reason":"dependency not pinned by hash detected -- score normalized to 6","details":["Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:597: update your workflow using https://app.stepsecurity.io/secureworkflow/surrealdb/surrealdb/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:738: update your workflow using https://app.stepsecurity.io/secureworkflow/surrealdb/surrealdb/ci.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:743: update your workflow using https://app.stepsecurity.io/secureworkflow/surrealdb/surrealdb/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:658: update your workflow using https://app.stepsecurity.io/secureworkflow/surrealdb/surrealdb/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql.yml:55: update your workflow using https://app.stepsecurity.io/secureworkflow/surrealdb/surrealdb/codeql.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql.yml:68: update your workflow using https://app.stepsecurity.io/secureworkflow/surrealdb/surrealdb/codeql.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/scorecard.yml:76: update your workflow using https://app.stepsecurity.io/secureworkflow/surrealdb/surrealdb/scorecard.yml/main?enable=pin","Warn: containerImage not pinned by hash: docker/Dockerfile:6","Warn: containerImage not pinned by hash: docker/Dockerfile:34","Warn: containerImage not pinned by hash: docker/Dockerfile:45","Warn: containerImage not pinned by hash: docker/Dockerfile:78","Warn: containerImage not pinned by hash: docker/Dockerfile:99","Warn: containerImage not pinned by hash: docker/Dockerfile:129","Warn: downloadThenRun not pinned by hash: docker/Dockerfile:13","Warn: nugetCommand not pinned by hash: .github/workflows/ci.yml:910: pin your dependecies by either enabling central package management (https://learn.microsoft.com/nuget/consume-packages/Central-Package-Management) or using a lockfile (https://learn.microsoft.com/nuget/consume-packages/package-references-in-project-files#locking-dependencies)","Info:  66 out of  71 GitHub-owned GitHubAction dependencies pinned","Info:  12 out of  14 third-party GitHubAction dependencies pinned","Info:   0 out of   6 containerImage dependencies pinned","Info:   0 out of   1 downloadThenRun dependencies pinned","Info:   0 out of   1 nugetCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/cd152cb6742c5b8f2f3d2b5193b41d9c50905198/docs/checks.md#pinned-dependencies"}},{"name":"SAST","score":7,"reason":"SAST tool detected but not run on all commits","details":["Info: SAST configuration detected: CodeQL","Warn: 10 commits out of 30 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/cd152cb6742c5b8f2f3d2b5193b41d9c50905198/docs/checks.md#sast"}},{"name":"Fuzzing","score":10,"reason":"project is fuzzed","details":["Info: OSSFuzz integration found","Info: RustCargoFuzzer integration found: fuzz/fuzz_targets/fuzz_executor.rs:3","Info: RustCargoFuzzer integration found: fuzz/fuzz_targets/fuzz_format.rs:3","Info: RustCargoFuzzer integration found: fuzz/fuzz_targets/fuzz_sql_parser.rs:3","Info: RustCargoFuzzer integration found: fuzz/fuzz_targets/fuzz_structured_executor.rs:3"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/cd152cb6742c5b8f2f3d2b5193b41d9c50905198/docs/checks.md#fuzzing"}},{"name":"Vulnerabilities","score":5,"reason":"5 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: RUSTSEC-2025-0141","Warn: Project is vulnerable to: RUSTSEC-2024-0436","Warn: Project is vulnerable to: RUSTSEC-2026-0001","Warn: Project is vulnerable to: RUSTSEC-2025-0134","Warn: Project is vulnerable to: RUSTSEC-2025-0118 / GHSA-hc7m-r6v8-hg9q"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/cd152cb6742c5b8f2f3d2b5193b41d9c50905198/docs/checks.md#vulnerabilities"}},{"name":"Branch-Protection","score":5,"reason":"branch protection is not maximal on development and all release branches","details":["Info: 'allow deletion' disabled on branch 'main'","Info: 'allow deletion' disabled on branch 'releases/2.4.0'","Info: 'force pushes' disabled on branch 'main'","Info: 'force pushes' disabled on branch 'releases/2.4.0'","Warn: 'branch protection settings apply to administrators' is disabled on branch 'main'","Warn: 'branch protection settings apply to administrators' is disabled on branch 'releases/2.4.0'","Info: 'stale review dismissal' is required to merge on branch 'main'","Info: 'stale review dismissal' is required to merge on branch 'releases/2.4.0'","Warn: required approving review count is 1 on branch 'main'","Warn: required approving review count is 1 on branch 'releases/2.4.0'","Info: codeowner review is required on branch 'main'","Info: codeowner review is required on branch 'releases/2.4.0'","Info: 'last push approval' is required to merge on branch 'main'","Info: 'last push approval' is required to merge on branch 'releases/2.4.0'","Info: 'up-to-date branches' is required to merge on branch 'main'","Warn: 'up-to-date branches' is disabled on branch 'releases/2.4.0'","Info: status check found to merge onto on branch 'main'","Info: status check found to merge onto on branch 'releases/2.4.0'","Info: PRs are required in order to make changes on branch 'main'","Info: PRs are required in order to make changes on branch 'releases/2.4.0'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/cd152cb6742c5b8f2f3d2b5193b41d9c50905198/docs/checks.md#branch-protection"}},{"name":"CI-Tests","score":10,"reason":"30 out of 30 merged PRs checked by a CI test -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project runs tests before pull requests are merged.","url":"https://github.com/ossf/scorecard/blob/cd152cb6742c5b8f2f3d2b5193b41d9c50905198/docs/checks.md#ci-tests"}},{"name":"Contributors","score":10,"reason":"project has 19 contributing companies or organizations","details":["Info: found contributions from: EPSILab, SoftbearStack, SoftbearStudios, StarlaneStudios, WebEnchanter, abcum, auditplus, deploy-ml, fixmyrights, jaeksoft, making streaming simple @rapidrecast, pbcms, playframework-ja, rethinkdb, softbear, surrealdb, surrealdb @helmfile @actions-runner-controller, theopensource-company, we-are-daveo"],"documentation":{"short":"Determines if the project has a set of contributors from multiple organizations (e.g., companies).","url":"https://github.com/ossf/scorecard/blob/cd152cb6742c5b8f2f3d2b5193b41d9c50905198/docs/checks.md#contributors"}}]},"last_synced_at":"2026-01-19T17:36:34.921Z","repository_id":37254102,"created_at":"2026-01-19T17:36:34.921Z","updated_at":"2026-01-19T17:36:34.921Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35199360,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-06T02:00:07.184Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["backend-as-a-service","cloud-database","database","database-as-a-service","developer-tools","devtools","distributed","distributed-database","document-database","graph-database","iot-database","nosql","realtime-database","serverless","sql","surreal","surrealdb","web"],"created_at":"2024-07-31T00:00:34.298Z","updated_at":"2026-07-06T17:00:26.630Z","avatar_url":"https://github.com/surrealdb.png","language":"Rust","funding_links":[],"categories":["Rust","Resources","Developer Tools","应用程序 Applications","数据库管理系统","🤖 AI, ML \u0026 Deep Learning","Applications","Libraries","database","web","💾 Databases","開発ツール","⚙️ Backend \u0026 APIs","Follow : Official","Vector DBs \u0026 Search Engines"],"sub_categories":["Official Resources","Databases","数据库 Database","网络服务_其他","Database","Other Database Systems:","データベース","Talks and Videos","Other Tools"],"readme":"\u003ca href=\"https://surrealdb.com#gh-dark-mode-only\" target=\"_blank\"\u003e\n    \u003cimg width=\"100%\" src=\"/img/white/hero.png\" alt=\"SurrealDB Hero\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://surrealdb.com#gh-light-mode-only\" target=\"_blank\"\u003e\n    \u003cimg width=\"100%\" src=\"/img/black/hero.png\" alt=\"SurrealDB Hero\"\u003e\n\u003c/a\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/surrealdb/surrealdb\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/surrealdb/surrealdb?color=ff00a0\u0026include_prereleases\u0026label=version\u0026sort=semver\u0026style=flat-square\"\u003e\u003c/a\u003e\n    \u0026nbsp;\n    \u003ca href=\"https://github.com/surrealdb/surrealdb\"\u003e\u003cimg src=\"https://img.shields.io/badge/built_with-Rust-dca282.svg?style=flat-square\"\u003e\u003c/a\u003e\n    \u0026nbsp;\n\t\u003ca href=\"https://github.com/surrealdb/surrealdb/actions\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/surrealdb/surrealdb/ci.yml?style=flat-square\u0026branch=main\"\u003e\u003c/a\u003e\n    \u0026nbsp;\n    \u003ca href=\"https://github.com/surrealdb/license\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-BSL_1.1-00bfff.svg?style=flat-square\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://hub.docker.com/repository/docker/surrealdb/surrealdb\"\u003e\u003cimg src=\"https://img.shields.io/docker/pulls/surrealdb/surrealdb?label=docker%20pulls\u0026style=flat-square\"\u003e\u003c/a\u003e\n    \u0026nbsp;\n    \u003ca href=\"https://crates.io/crates/surrealdb\"\u003e\u003cimg src=\"https://img.shields.io/crates/d/surrealdb?color=dca282\u0026label=rust\u0026style=flat-square\"\u003e\u003c/a\u003e\n\t\u0026nbsp;\n    \u003ca href=\"https://www.npmjs.com/package/surrealdb.js\"\u003e\u003cimg src=\"https://img.shields.io/npm/dt/surrealdb.js?color=f7df1e\u0026label=javascript\u0026style=flat-square\"\u003e\u003c/a\u003e\n    \u0026nbsp;\n\t\u003ca href=\"https://pypi.org/project/surrealdb/\"\u003e\u003cimg src=\"https://img.shields.io/pepy/dt/surrealdb?color=426c99\u0026label=python\u0026style=flat-square\"\u003e\u003c/a\u003e\n\t\u0026nbsp;\n\t\u003ca href=\"https://www.nuget.org/packages/SurrealDb.Net\"\u003e\u003cimg src=\"https://img.shields.io/nuget/dt/surrealdb.net?color=4c2dcc\u0026label=.NET\u0026style=flat-square\"\u003e\u003c/a\u003e\n\t\u0026nbsp;\n\t\u003ca href=\"https://packagist.org/packages/surrealdb/surrealdb.php\"\u003e\u003cimg src=\"https://img.shields.io/packagist/dt/surrealdb/surrealdb.php?color=4d588b\u0026label=php\u0026style=flat-square\"\u003e\u003c/a\u003e\n    \u0026nbsp;\n\t\u003ca href=\"https://hub.docker.com/repository/docker/surrealdb/surrealdb\"\u003e\u003cimg src=\"https://img.shields.io/github/downloads/surrealdb/surrealdb/total?color=8259dd\u0026label=github%20downloads\u0026style=flat-square\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\t\u003ca href=\"https://surrealdb.com/discord\"\u003e\u003cimg src=\"https://img.shields.io/discord/902568124350599239?label=discord\u0026style=flat-square\u0026color=5a66f6\" alt=\"Discord\"\u003e\u003c/a\u003e\n\t\u0026nbsp;\n    \u003ca href=\"https://x.com/surrealdb\"\u003e\u003cimg src=\"https://img.shields.io/badge/x-follow_us-222222.svg?style=flat-square\" alt=\"X\"\u003e\u003c/a\u003e\n    \u0026nbsp;\n    \u003ca href=\"https://dev.to/surrealdb\"\u003e\u003cimg src=\"https://img.shields.io/badge/dev-join_us-86f7b7.svg?style=flat-square\" alt=\"Dev\"\u003e\u003c/a\u003e\n    \u0026nbsp;\n    \u003ca href=\"https://www.linkedin.com/company/surrealdb/\"\u003e\u003cimg src=\"https://img.shields.io/badge/linkedin-connect_with_us-0a66c2.svg?style=flat-square\" alt=\"LinkedIn\"\u003e\u003c/a\u003e\n\t\u0026nbsp;\n    \u003ca href=\"https://www.youtube.com/@surrealdb\"\u003e\u003cimg src=\"https://img.shields.io/badge/youtube-subscribe-fc1c1c.svg?style=flat-square\" alt=\"YouTube\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\t\u003ca href=\"https://surrealdb.com/blog\"\u003e\u003cimg height=\"25\" src=\"./img/social/blog.svg\" alt=\"Blog\"\u003e\u003c/a\u003e\n\t\u0026nbsp;\n\t\u003ca href=\"https://github.com/surrealdb/surrealdb\"\u003e\u003cimg height=\"25\" src=\"./img/social/github.svg\" alt=\"Github\"\u003e\u003c/a\u003e\n\t\u0026nbsp;\n    \u003ca href=\"https://www.linkedin.com/company/surrealdb/\"\u003e\u003cimg height=\"25\" src=\"./img/social/linkedin.svg\" alt=\"LinkedIn\"\u003e\u003c/a\u003e\n    \u0026nbsp;\n    \u003ca href=\"https://x.com/surrealdb\"\u003e\u003cimg height=\"25\" src=\"./img/social/x.svg\" alt=\"X\"\u003e\u003c/a\u003e\n    \u0026nbsp;\n    \u003ca href=\"https://www.youtube.com/@surrealdb\"\u003e\u003cimg height=\"25\" src=\"./img/social/youtube.svg\" alt=\"YouTube\"\u003e\u003c/a\u003e\n    \u0026nbsp;\n    \u003ca href=\"https://dev.to/surrealdb\"\u003e\u003cimg height=\"25\" src=\"./img/social/dev.svg\" alt=\"Dev\"\u003e\u003c/a\u003e\n    \u0026nbsp;\n    \u003ca href=\"https://surrealdb.com/discord\"\u003e\u003cimg height=\"25\" src=\"./img/social/discord.svg\" alt=\"Discord\"\u003e\u003c/a\u003e\n    \u0026nbsp;\n    \u003ca href=\"https://stackoverflow.com/questions/tagged/surrealdb\"\u003e\u003cimg height=\"25\" src=\"./img/social/stack-overflow.svg\" alt=\"Stack Overflow\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cbr\u003e\n\n\u003ch2\u003e\u003cimg height=\"20\" src=\"./img/whatissurreal.svg\"\u003e\u0026nbsp;\u0026nbsp;What is SurrealDB?\u003c/h2\u003e\n\nSurrealDB is a multi-model database built in Rust designed to unify multiple data models into a single engine. SurrealDB combines document, graph, relational, time-series, geospatial and key-value data types with powerful search and retrieval functionalities (full-text, vector, hybrid) and real-time and event-driven capabilities, enabling developers to build powerful applications faster and more efficiently. SurrealDB can also be used as a backend-as-a-service given its support for end user authentication. Given that it’s a single Rust binary, SurrealDB can run embedded (in‐app), in the browser (via WebAssembly), in the edge, self-hosted as single backend node, or in a distributed cluster in the cloud.\n\nSurrealDB is used for data-intensive systems such as applications requiring multiple data types, data layer for AI agents, knowledge graphs, real-time apps (e.g. recommendation engines, fraud detection systems) and embedded/edge systems. With SurrealDB, you can simplify your database and API infrastructure, reduce development time, and build secure, performant apps quickly and cost-effectively.\n\n**Key features of SurrealDB include:**\n\n- **Reduces development time**: SurrealDB simplifies your database and API stack by removing the need for most server-side components, allowing you to build secure, performant apps faster and cheaper.\n- **Multi-model**: native multi-model support for document, graph, relational (enforcing schema and schemaless), time-series, geospatial and retrieval (full-text, vector, hybrid). This is offered natively through SurrealQL, SurrealDB's SQL-like intuitive query language.\n- **Real-time collaborative API backend service:** SurrealDB functions as both a database and an API backend service, enabling real-time collaboration.\n- **Support for multiple querying languages:** SurrealDB supports SQL querying from client devices, GraphQL, ACID transactions, WebSocket connections, structured and unstructured data, graph querying, full-text and vector indexing, and geospatial querying.\n- **Granular access control**: SurrealDB provides row-level permissions-based access control, giving you the ability to manage data access with precision.\n\nView the [features](https://surrealdb.com/features), the latest [releases](https://surrealdb.com/releases), and [documentation](https://surrealdb.com/docs).\n\n\u003cimg width=\"100%\" src=\"./img/interface.png\" alt=\"Surrealist\"\u003e\n\n\u003ch2\u003e\u003cimg height=\"20\" src=\"./img/contents.svg\"\u003e\u0026nbsp;\u0026nbsp;Contents\u003c/h2\u003e\n\n- [Database, API, and permissions](#database-api-and-permissions)\n- [Tables, documents, and graph](#tables-documents-and-graph)\n- [Advanced inter-document relations and analysis. No JOINs. No pain.](#advanced-inter-document-relations-and-analysis-no-joins-no-pain)\n- [Simple schema definition for frontend and backend development](#simple-schema-definition-for-frontend-and-backend-development)\n- [Connect and query directly from web-browsers and client devices](#connect-and-query-directly-from-web-browsers-and-client-devices)\n- [Query the database with the tools you want](#query-the-database-with-the-tools-you-want)\n- [Realtime live queries and data changes direct to application](#realtime-live-queries-and-data-changes-direct-to-application)\n- [Scale effortlessly to hundreds of nodes for high-availability and scalability](#scale-effortlessly-to-hundreds-of-nodes-for-high-availability-and-scalability)\n- [Extend your database with JavaScript functions](#extend-your-database-with-javascript-functions)\n- [Designed to be embedded or to run distributed in the cloud](#designed-to-be-embedded-or-to-run-distributed-in-the-cloud)\n\n\u003ch2\u003e\u003cimg height=\"20\" src=\"./img/features.svg\"\u003e\u0026nbsp;\u0026nbsp;Features\u003c/h2\u003e\n\n- [x] Database server, or embedded library\n- [x] Multi-row, multi-table ACID transactions\n- [x] Single-node, or highly-scalable distributed mode\n- [x] Record links and directed typed graph connections\n- [x] Store structured and unstructured data\n- [x] Incrementally computed views for pre-computed advanced analytics\n- [x] Realtime-API layer, and security permissions built in\n- [x] Store and model data in any way with tables, documents, and graph\n- [x] Simple schema definition for frontend and backend development\n- [x] Connect and query directly from web-browsers and client devices\n- [x] Use embedded JavaScript functions for custom advanced functionality\n- [x] MCP (Model Context Protocol) server for LLM and AI-agent integration\n\n\u003ch2\u003e\u003cimg height=\"20\" src=\"./img/documentation.svg\"\u003e\u0026nbsp;\u0026nbsp;Documentation\u003c/h2\u003e\n\nFor guidance on installation, development, deployment, and administration, take a look at the following resources:\n\n- Documentation: https://surrealdb.com/docs\n- SurrealDB University: https://surrealdb.com/learn\n- Aeon's Surreal Renaissance (interactive book): https://surrealdb.com/learn/book\n\n\u003ch2\u003e\u003cimg height=\"20\" src=\"./img/gettingstarted.svg\"\u003e\u0026nbsp;\u0026nbsp;Getting started\u003c/h2\u003e\n\nGetting started with SurrealDB is as easy as starting up the SurrealDB database server, choosing your platform, and integrating its SDK into your code. You can easily get started with your platform of choice by reading one of our tutorials.\n\n**Server side code**\n\n\u003cp\u003e\n    \u003ca href=\"https://surrealdb.com/docs/integration/sdks/rust\"\u003e\u003cimg width=60 title=\"Rust\" src=\"https://raw.githubusercontent.com/surrealdb/icons/main/rust.svg\" /\u003e\u003c/a\u003e\n    \u0026nbsp;\n    \u003ca href=\"https://surrealdb.com/docs/integration/sdks/javascript\"\u003e\u003cimg width=60 title=\"JavaScript\" src=\"https://raw.githubusercontent.com/surrealdb/icons/main/javascript.svg\" /\u003e\u003c/a\u003e\n\t\u0026nbsp;\n    \u003ca href=\"https://surrealdb.com/docs/sdk/javascript/engines/wasm\"\u003e\u003cimg width=60 title=\"WebAssembly\" src=\"https://raw.githubusercontent.com/surrealdb/icons/main/webassembly.svg\" /\u003e\u003c/a\u003e\n\t\u0026nbsp;\n    \u003ca href=\"https://surrealdb.com/docs/sdk/javascript/engines/node\"\u003e\u003cimg width=60 title=\"Node.js\" src=\"https://raw.githubusercontent.com/surrealdb/icons/main/nodejs.svg\" /\u003e\u003c/a\u003e\n\t\u0026nbsp;\n    \u003ca href=\"https://surrealdb.com/docs/integration/sdks/javascript\"\u003e\u003cimg width=60 title=\"Deno\" src=\"https://raw.githubusercontent.com/surrealdb/icons/main/deno.svg\" /\u003e\u003c/a\u003e\n\t\u0026nbsp;\n\t\u003ca href=\"https://surrealdb.com/docs/integration/sdks/python\"\u003e\u003cimg width=60 title=\"Python\" src=\"https://raw.githubusercontent.com/surrealdb/icons/main/python.svg\" /\u003e\u003c/a\u003e\n\t\u0026nbsp;\n    \u003ca href=\"https://surrealdb.com/docs/integration/sdks/golang\"\u003e\u003cimg width=60 title=\"Golang\" src=\"https://raw.githubusercontent.com/surrealdb/icons/main/golang.svg\" /\u003e\u003c/a\u003e\n\t\u0026nbsp;\n    \u003ca href=\"https://surrealdb.com/docs/integration/sdks/dotnet\"\u003e\u003cimg width=60 title=\".NET\" src=\"https://raw.githubusercontent.com/surrealdb/icons/main/dotnet.svg\" /\u003e\u003c/a\u003e\n\t\u0026nbsp;\n    \u003ca href=\"https://surrealdb.com/docs/integration/sdks/php\"\u003e\u003cimg width=60 title=\"PHP\" src=\"https://raw.githubusercontent.com/surrealdb/icons/main/php.svg\" /\u003e\u003c/a\u003e\n\t\u0026nbsp;\n    \u003ca href=\"https://surrealdb.com/docs/integration/sdks/java\"\u003e\u003cimg width=60 title=\"Java\" src=\"https://raw.githubusercontent.com/surrealdb/icons/main/java.svg\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n**Client side apps**\n\n\u003cp\u003e\n\t\u003ca href=\"https://surrealdb.com/docs/integration/sdks/javascript\"\u003e\u003cimg width=60 title=\"JavaScript\" src=\"https://raw.githubusercontent.com/surrealdb/icons/main/javascript.svg\" /\u003e\u003c/a\u003e\n    \u0026nbsp;\n    \u003ca href=\"https://surrealdb.com/docs/sdk/javascript/engines/wasm\"\u003e\u003cimg width=60 title=\"WebAssembly\" src=\"https://raw.githubusercontent.com/surrealdb/icons/main/webassembly.svg\" /\u003e\u003c/a\u003e\n\t\u0026nbsp;\n    \u003ca href=\"https://surrealdb.com/docs/integration/sdks/javascript\"\u003e\u003cimg width=60 title=\"React\" src=\"https://raw.githubusercontent.com/surrealdb/icons/main/reactjs.svg\" /\u003e\u003c/a\u003e\n\t\u0026nbsp;\n    \u003ca href=\"https://surrealdb.com/docs/integration/sdks/javascript\"\u003e\u003cimg width=60 title=\"Next.js\" src=\"https://raw.githubusercontent.com/surrealdb/icons/main/nextjs.svg\" /\u003e\u003c/a\u003e\n\t\u0026nbsp;\n    \u003ca href=\"https://surrealdb.com/docs/integration/sdks/ember\"\u003e\u003cimg width=60 title=\"Ember.js\" src=\"https://raw.githubusercontent.com/surrealdb/icons/main/emberjs.svg\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003ch2\u003e\u003cimg height=\"20\" src=\"/img/cloud.svg?raw=true\"\u003e\u0026nbsp;\u0026nbsp;SurrealDB Cloud\u003c/h2\u003e\n\n\u003ca href=\"https://surrealdb.com/cloud#gh-dark-mode-only\" target=\"_blank\"\u003e\n    \u003cimg width=\"100%\" src=\"/img/white/cloud.png\" alt=\"SurrealDB Cloud\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://surrealdb.com/cloud#gh-light-mode-only\" target=\"_blank\"\u003e\n    \u003cimg width=\"100%\" src=\"/img/black/cloud.png\" alt=\"SurrealDB Cloud\"\u003e\n\u003c/a\u003e\n\nSurrealDB is available as a [managed cloud service](https://app.surrealdb.com/overview). Forget about infrastructure operations, monitoring, backups or capacity planning. [SurrealDB Cloud](https://surrealdb.com/cloud) allows you to focus on building great products using the power and flexibility of SurrealDB in just a few clicks. Grow from prototype to enterprise-scale. The SurrealDB Cloud scalable architecture allows your database to evolve as your application grows, ensuring you are always ahead of demand. However if you want to deploy SurrealDB yourself, keep reading below.\n\n\u003ch2\u003e\u003cimg height=\"20\" src=\"./img/installation.svg\"\u003e\u0026nbsp;\u0026nbsp;Installation\u003c/h2\u003e\n\nSurrealDB is designed to be simple to install and simple to run - using just one command from your terminal. In addition to traditional installation, SurrealDB can be installed and run with HomeBrew, Docker, or using any other container orchestration tool such as Docker Compose, Docker Swarm, Rancher, or in Kubernetes.\n\n\u003ch4\u003e\u003ca href=\"https://surrealdb.com/install\"\u003e\u003cimg width=\"20\" src=\"./img/apple.svg\"\u003e\u003c/a\u003e\u0026nbsp;Install on macOS\u003c/h4\u003e\n\nThe quickest way to get going with SurrealDB on macOS is to use Homebrew. This will install both the command-line tools, and the SurrealDB server as a single executable. If you don't use Homebrew, follow the instructions for Linux below to install SurrealDB.\n\n```bash\nbrew install surrealdb/tap/surreal\n```\n\nIf you want to test a version with the latest features, published every night, install the `nightly` version:\n\n```bash\nbrew install surrealdb/tap/surreal-nightly\n```\n\n\u003ch4\u003e\u003ca href=\"https://surrealdb.com/install\"\u003e\u003cimg width=\"20\" src=\"./img/linux.svg\"\u003e\u003c/a\u003e\u0026nbsp;Install on Linux\u003c/h4\u003e\n\nThe easiest and preferred way to get going with SurrealDB on Unix operating systems is to install and use the SurrealDB command-line tool. Run the following command in your terminal and follow the on-screen instructions.\n\n```bash\ncurl --proto '=https' --tlsv1.2 -sSf https://install.surrealdb.com | sh\n```\n\nIf you want to run a beta release, before the next version is released, the `beta` version:\n\n```bash\ncurl --proto '=https' --tlsv1.2 -sSf https://install.surrealdb.com | sh -s -- --beta\n```\n\nIf you want to test a version with the latest features, published every night, install the `nightly` version:\n\n```bash\ncurl --proto '=https' --tlsv1.2 -sSf https://install.surrealdb.com | sh -s -- --nightly\n```\n\n\u003ch4\u003e\u003ca href=\"https://surrealdb.com/install\"\u003e\u003cimg width=\"20\" src=\"./img/windows.svg\"\u003e\u003c/a\u003e\u0026nbsp;Install on Windows\u003c/h4\u003e\n\nThe easiest and preferred way to get going with SurrealDB on Windows is to install and use the SurrealDB command-line tool. Run the following command in your terminal and follow the on-screen instructions.\n\n```ps1\niwr https://windows.surrealdb.com -useb | iex\n```\n\nIf you want to test a version with the latest features, published every night, install the `nightly` version:\n\n```ps1\niex \"\u0026 { $(irm https://windows.surrealdb.com) } -Nightly\"\n```\n\n\u003ch4\u003e\u003ca href=\"https://surrealdb.com/install\"\u003e\u003cimg width=\"20\" src=\"./img/docker.svg\"\u003e\u003c/a\u003e\u0026nbsp;Run using Docker\u003c/h4\u003e\n\nDocker 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.\n\n```bash\ndocker run --rm --pull always --name surrealdb -p 8000:8000 surrealdb/surrealdb:latest start\n```\n\nFor 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.\n\n```bash\ndocker run --rm --pull always --name surrealdb -p 8000:8000 surrealdb/surrealdb:latest start --log info --user root --pass root memory\n``` \n\n\u003ch2\u003e\u003cimg height=\"20\" src=\"./img/features.svg\"\u003e\u0026nbsp;\u0026nbsp;Quick look\u003c/h2\u003e\n\nWith strongly-typed data types, data can be fully modelled right in the database.\n\n```surrealql\nUPDATE person SET\n    waist = \u003cint\u003e \"34\",\n    height = \u003cfloat\u003e 201,\n    score = \u003cdecimal\u003e 0.3 + 0.3 + 0.3 + 0.1\n;\n```\n\nStore dynamically computed fields which are calculated when retrieved.\n\n```surrealql\nDEFINE FIELD can_drive ON TABLE person COMPUTED time::now() \u003e birthday + 18y;\nCREATE person SET birthday = d\"2007-06-22\";\n;\n```\n\nEasily work with unstructured or structured data, in schema-less or schema-full mode.\n\n```surrealql\n-- Create a schemafull table\nDEFINE TABLE user SCHEMAFULL;\n\n-- Specify fields on the user table\nDEFINE FIELD name ON TABLE user TYPE object;\nDEFINE FIELD name.first ON TABLE user TYPE string;\nDEFINE FIELD name.last ON TABLE user TYPE string;\nDEFINE FIELD email ON TABLE user TYPE string ASSERT string::is_email($value);\n\n-- Add a unique index on the email field preventing duplicate values\nDEFINE INDEX email ON TABLE user COLUMNS email UNIQUE;\n\n-- Create a new event whenever a user changes their email address\nDEFINE EVENT email ON TABLE user WHEN $before.email != $after.email THEN (\n    CREATE event SET user = $value, time = time::now(), value = $after.email, action = 'email_changed'\n);\n```\n\nConnect records together with fully directed graph edge connections.\n\n```surrealql\n-- Add a graph edge between user:tobie and article:surreal\nRELATE user:tobie-\u003ewrite-\u003earticle:surreal\n    SET time.written = time::now()\n;\n\n-- Add a graph edge between specific users and developers\nLET $from = (SELECT users FROM company:surrealdb);\nLET $devs = (SELECT * FROM user WHERE tags CONTAINS 'developer');\nRELATE $from-\u003elike-\u003e$devs UNIQUE\n    SET time.connected = time::now()\n;\n```\n\nQuery data flexibly with advanced expressions and graph queries.\n\n```surrealql\n-- Select a nested array, and filter based on an attribute\nSELECT emails[WHERE active = true] FROM person;\n\n-- Select all 1st, 2nd, and 3rd level people who this specific person record knows, or likes, as separate outputs\nSELECT -\u003eknows-\u003e(? AS f1)-\u003eknows-\u003e(? AS f2)-\u003e(knows, likes AS e3 WHERE influencer = true)-\u003e(? AS f3) FROM person:tobie;\n\n-- Select all person records (and their recipients), who have sent more than 5 emails\nSELECT *, -\u003esent-\u003eemail-\u003eto-\u003eperson FROM person WHERE count(-\u003esent-\u003eemail) \u003e 5;\n\n-- Select other products purchased by people who purchased this laptop\nSELECT \u003c-purchased\u003c-person-\u003epurchased-\u003eproduct FROM product:laptop;\n\n-- Select products purchased by people in the last 3 weeks who have purchased the same products that we purchased\nSELECT -\u003epurchased-\u003eproduct\u003c-purchased\u003c-person-\u003e(purchased WHERE created_at \u003e time::now() - 3w)-\u003eproduct FROM person:tobie;\n```\n\nStore GeoJSON geographical data types, including points, lines and polygons.\n\n```surrealql\nUPDATE city:london SET\n    centre = (-0.118092, 51.509865),\n    boundary = {\n        type: \"Polygon\",\n        coordinates: [[\n            [-0.38314819, 51.37692386], [0.1785278, 51.37692386],\n            [0.1785278, 51.61460570], [-0.38314819, 51.61460570],\n            [-0.38314819, 51.37692386]\n        ]]\n    }\n;\n```\n\nWrite custom embedded logic using JavaScript functions.\n\n```surrealql\nCREATE film SET\n    ratings = [\n        { rating: 6, user: user:bt8e39uh1ouhfm8ko8s0 },\n        { rating: 8, user: user:bsilfhu88j04rgs0ga70 },\n    ],\n    featured = function() {\n        return this.ratings.filter(r =\u003e {\n            return r.rating \u003e= 7;\n        }).map(r =\u003e {\n            return { ...r, rating: r.rating * 10 };\n        });\n    }\n;\n```\n\nSpecify granular access permissions for client and application access.\n\n```surrealql\n-- Specify access permissions for the 'post' table\nDEFINE TABLE post SCHEMALESS\n    PERMISSIONS\n        FOR select\n            -- Published posts can be selected\n            WHERE published = true\n            -- A user can select all their own posts\n            OR user = $auth.id\n        FOR create, update\n            -- A user can create or update their own posts\n            WHERE user = $auth.id\n        FOR delete\n            -- A user can delete their own posts\n            WHERE user = $auth.id\n            -- Or an admin can delete any posts\n            OR $auth.admin = true\n;\n```\n\n\u003ch2\u003e\u003cimg height=\"20\" src=\"./img/features.svg\"\u003e\u0026nbsp;\u0026nbsp;Why SurrealDB?\u003c/h2\u003e\n\n\u003cp\u003e\n\t\u003cimg width=\"49%\" src=\"./img/illustrations/database-api-security.jpg\" /\u003e\n\t\u003cimg width=\"49%\" src=\"./img/illustrations/multimodel-database.jpg\" /\u003e\n\u003c/p\u003e\n\n### Database, API, and permissions\n\nSurrealDB combines the database layer, the querying layer, and the API and authentication layer into one platform. Advanced table-based and row-based customisable access permissions allow for granular data access patterns for different types of users. There's no need for custom backend code and security rules with complicated database development.\n\n### Tables, documents, and graph\n\nAs a multi-model database, SurrealDB enables developers to use multiple techniques to store and model data, without having to choose a method in advance. With the use of tables, SurrealDB has similarities with relational databases, but with the added functionality and flexibility of advanced nested fields and arrays. Inter-document record links allow for simple to understand and highly-performant related queries without the use of JOINs, eliminating the N+1 query problem.\n\n\u003cp\u003e\n\t\u003cimg width=\"49%\" src=\"./img/illustrations/graph-database.jpg\" /\u003e\n\t\u003cimg width=\"49%\" src=\"./img/illustrations/schema-direct-to-client.jpg\" /\u003e\n\u003c/p\u003e\n\n### Advanced inter-document relations and analysis. No JOINs. No pain.\n\nWith full graph database functionality SurrealDB enables more advanced querying and analysis. Records (or vertices) can be connected to one another with edges, each with its own record properties and metadata. Simple extensions to traditional SQL queries allow for multi-table, multi-depth document retrieval, efficiently in the database, without the use of complicated JOINs and without bringing the data down to the client.\n\n### Simple schema definition for frontend and backend development\n\nWith SurrealDB, specify your database and API schema in one place, and define column rules and constraints just once. Once a schema is defined, database access is automatically granted to the relevant users. No more custom API code, and no more GraphQL integration. Simple, flexible, and ready for production in minutes not months.\n\n\u003cp\u003e\n\t\u003cimg width=\"49%\" src=\"./img/illustrations/browser-sync.jpg\" /\u003e\n\t\u003cimg width=\"49%\" src=\"./img/illustrations/multiple-integrations.jpg\" /\u003e\n\u003c/p\u003e\n\n### Connect and query directly from web-browsers and client devices\n\nConnect directly to SurrealDB from any end-user client device. Run SurrealQL queries directly within web-browsers, ensuring that users can only view or modify the data that they are allowed to access. Highly-performant WebSocket connections allow for efficient bi-directional queries, responses and notifications.\n\n### Query the database with the tools you want\n\nYour data, your choice. SurrealDB is designed to be flexible to use, with support for SurrealQL, GraphQL (coming soon), CRUD support over REST, and JSON-RPC querying and modification over WebSockets. With direct-to-client connection with in-built permissions, SurrealDB speeds up the development process, and fits in seamlessly into any tech stack.\n\n\u003cp\u003e\n\t\u003cimg width=\"49%\" src=\"./img/illustrations/realtime-live-queries.jpg\" /\u003e\n\t\u003cimg width=\"49%\" src=\"./img/illustrations/scale-up.jpg\" /\u003e\n\u003c/p\u003e\n\n### Realtime live queries and data changes direct to application\n\nSurrealDB keeps every client device in-sync with data modifications pushed in realtime to the clients, applications, end-user devices, and server-side libraries. Live SQL queries allow for advanced filtering of the changes to which a client subscribes, and efficient data formats, including DIFFing and PATCHing enable highly-performant web-based data syncing.\n\n### Scale effortlessly to hundreds of nodes for high-availability and scalability\n\nSurrealDB can be run as a single in-memory node, or as part of a distributed cluster - offering highly-available and highly-scalable system characteristics. Designed from the ground up to run in a distributed environment, SurrealDB makes use of special techniques when handling multi-table transactions, and document record IDs - with no use of table or row locks.\n\n\u003cp\u003e\n\t\u003cimg width=\"49%\" src=\"./img/illustrations/database-plugins.jpg\" /\u003e\n\t\u003cimg width=\"49%\" src=\"./img/illustrations/cloud-or-embedded.jpg\" /\u003e\n\u003c/p\u003e\n\n### Extend your database with JavaScript functions\n\nEmbedded JavaScript functions allow for advanced, custom functionality, with computation logic being moved to the data layer. This improves upon the traditional approach of moving data to the client devices before applying any computation logic, ensuring that only the necessary data is transferred remotely. These advanced JavaScript functions, with support for the ES2020 standard, allow any developer to analyse the data in ever more simple-yet-advanced ways.\n\n### Designed to be embedded or to run distributed in the cloud\n\nBuilt entirely in Rust as a single library, SurrealDB is designed to be used as both an embedded database library with advanced querying functionality, and as a database server which can operate in a distributed cluster. With low memory usage and cpu requirements, the system requirements have been specifically thought through for running in all types of environment.\n\n\u003ch2\u003e\u003cimg height=\"20\" src=\"./img/community.svg\"\u003e\u0026nbsp;\u0026nbsp;Community\u003c/h2\u003e\n\nJoin our growing community around the world, for help, ideas, and discussions regarding SurrealDB.\n\n- View our official [Blog](https://surrealdb.com/blog)\n- Chat live with us on [Discord](https://surrealdb.com/discord)\n- Follow us on [X](https://x.com/surrealdb)\n- Connect with us on [LinkedIn](https://www.linkedin.com/company/surrealdb/)\n- Join the discussion on [Reddit](https://www.reddit.com/r/surrealdb/)\n- Visit us on [YouTube](https://www.youtube.com/@surrealdb)\n- Join our [Dev community](https://dev.to/surrealdb)\n- Questions tagged #surrealdb on [Stack Overflow](https://stackoverflow.com/questions/tagged/surrealdb)\n\n\u003ch2\u003e\u003cimg height=\"20\" src=\"./img/contributing.svg\"\u003e\u0026nbsp;\u0026nbsp;Contributing\u003c/h2\u003e\n\nWe would \u0026nbsp;\u003cimg width=\"15\" src=\"./img/love.svg\"\u003e\u0026nbsp; 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](CONTRIBUTING.md).\n\n**For maintainers**: See the [release process documentation](doc/RELEASING.md) for information about performing releases.\n\n\u003ch2\u003e\u003cimg height=\"20\" src=\"./img/security.svg\"\u003e\u0026nbsp;\u0026nbsp;Security\u003c/h2\u003e\n\nFor security issues, view our [vulnerability policy](https://github.com/surrealdb/surrealdb/security/policy), view our [Trust and Security page](https://surrealdb.com/legal/category/security), and kindly email us at [security@surrealdb.com](mailto:security@surrealdb.com) instead of posting a public issue on GitHub.\n\n\u003ch2\u003e\u003cimg height=\"20\" src=\"./img/license.svg\"\u003e\u0026nbsp;\u0026nbsp;License\u003c/h2\u003e\n\nSource code for SurrealDB is variously licensed under a number of different licenses. A copy of each license can be found in [each repository](https://github.com/surrealdb).\n\n- Libraries and SDKs, each located in its own distinct repository, are released under either the [Apache License 2.0](https://github.com/surrealdb/license/blob/main/APL.txt) or [MIT License](https://github.com/surrealdb/license/blob/main/MIT.txt).\n- Certain core database components, each located in its own distinct repository, are released under the [Apache License 2.0](https://github.com/surrealdb/license/blob/main/APL.txt).\n- Core database code for SurrealDB, located in [this repository](https://github.com/surrealdb/surrealdb), is released under the [Business Source License 1.1](/LICENSE).\n\nFor more information, see the [licensing information](https://github.com/surrealdb/license).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsurrealdb%2Fsurrealdb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsurrealdb%2Fsurrealdb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsurrealdb%2Fsurrealdb/lists"}