templates/compose/surrealdb.yaml: standalone SurrealDB instance using RocksDB as the storage backend. Suitable for development and single-node deployments.templates/compose/surrealdb-with-tikv.yaml: distributed setup with PD + TiKV + SurrealDB. Suitable for production workloads that need horizontal scalability.public/svgs/surrealdb.svg: official logo from simple-icons.Both templates use SurrealDB v3.0.1 (latest stable release as of Feb 2026) with SERVICE_USER_SURREALDB and SERVICE_PASSWORD_SURREALDB for auto-generated credentials. Health checks use the built-in surreal isready command.
The TiKV template starts PD first, waits for it to become healthy, then starts TiKV, then SurrealDB — so the dependency chain is correct and deployments won’t fail on cold starts.
Tested by deploying the surrealdb template on a Coolify instance (self-hosted, v4.0.0-beta). The service came up healthy and the Surrealist web UI connected to it at the service URL.
templates/compose/surrealdb.yaml and deploycurl -H "Accept: application/json" https://<your-domain>/healthsurrealdb-with-tikv.yaml. Allow ~60s for PD and TiKV to initialize before SurrealDB connects.[!IMPORTANT]
- I have read and understood the contributor guidelines. If I have failed to follow any guideline, I understand that this PR may be closed without review.
- I have tested the changes thoroughly and am confident that they will work as expected without issues when the maintainer tests them
mariusfit
@mariusfit
Jordan Hall
@Jordan-Hall