Installation
There are a number of ways of running SurrealDB. It can either be installed from a binary image, or it can be run from within Docker. Once installed, the surreal
command is a single executable which can be used to backup, interact with, and run SurrealDB server instances.
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.
docker run --rm -p 8000:8000 surrealdb/surrealdb:latest start
Installing on macOS
The 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.
user@localhost % brew install surrealdb/tap/surreal
Once installed, you can run the SurrealDB command-line tool by using the surreal
command. To check whether the install was successful run the following command in your terminal.
user@localhost % surreal help
The result should look similar to the output below, confirming that the SurrealDB command-line tool was installed successfully.
.d8888b. 888 8888888b. 888888b.
d88P Y88b 888 888 'Y88b 888 '88b
Y88b. 888 888 888 888 .88P
'Y888b. 888 888 888d888 888d888 .d88b. 8888b. 888 888 888 8888888K.
'Y88b. 888 888 888P' 888P' d8P Y8b '88b 888 888 888 888 'Y88b
'888 888 888 888 888 88888888 .d888888 888 888 888 888 888
Y88b d88P Y88b 888 888 888 Y8b. 888 888 888 888 .d88P 888 d88P
'Y8888P' 'Y88888 888 888 'Y8888 'Y888888 888 8888888P' 8888888P'
SurrealDB command-line interface and server
To get started using SurrealDB, and for guides on connecting to and building applications
on top of SurrealDB, check out the SurrealDB documentation (https://surrealdb.com/docs).
If you have questions or ideas, join the SurrealDB community (https://surrealdb.com/community).
If you find a bug, submit an issue on Github (https://github.com/surrealdb/surrealdb/issues).
We would love it if you could star the repository (https://github.com/surrealdb/surrealdb).
----------
USAGE:
surreal [SUBCOMMAND]
OPTIONS:
-h, --help Print help information
SUBCOMMANDS:
start Start the database server
backup Backup data to or from an existing database
import Import a SQL script into an existing database
export Export an existing database into a SQL script
version Output the command-line tool version information
sql Start an SQL REPL in your terminal with pipe support
help Print this message or the help of the given subcommand(s)
Installing on Linux
The 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.
user@localhost % curl -sSf https://install.surrealdb.com | sh
Once the script has finished installing, it will tell you where it has installed the SurrealDB command-line tool. If it had the necessary permissions, it will install into /usr/local/bin
, otherwise it will install into your home directory.
.d8888b. 888 8888888b. 888888b.
d88P Y88b 888 888 'Y88b 888 '88b
Y88b. 888 888 888 888 .88P
'Y888b. 888 888 888d888 888d888 .d88b. 8888b. 888 888 888 8888888K.
'Y88b. 888 888 888P' 888P' d8P Y8b '88b 888 888 888 888 'Y88b
'888 888 888 888 888 88888888 .d888888 888 888 888 888 888
Y88b d88P Y88b 888 888 888 Y8b. 888 888 888 888 .d88P 888 d88P
'Y8888P' 'Y88888 888 888 'Y8888 'Y888888 888 8888888P' 8888888P'
Fetching the latest database version...
Fetching the host system architecture...
Installing surreal-v1.0.0-beta.5 for linux-amd64...
SurrealDB successfully installed in:
/home/tobie/.surrealdb/surreal
To ensure that surreal is in your $PATH run:
PATH=/home/tobie/.surrealdb:$PATH
Or to move the binary to /usr/local/bin run:
sudo mv /home/tobie/.surrealdb/surreal /usr/local/bin
To see the command-line options run:
surreal help
To start an in-memory database server run:
surreal start --log debug --user root --pass root memory
For help with getting started visit:
https://surrealdb.com/docs
To check whether the install was successful run the following command in your terminal.
user@localhost % surreal help
The result should look similar to the output below, confirming that the SurrealDB command-line tool was installed successfully.
.d8888b. 888 8888888b. 888888b.
d88P Y88b 888 888 'Y88b 888 '88b
Y88b. 888 888 888 888 .88P
'Y888b. 888 888 888d888 888d888 .d88b. 8888b. 888 888 888 8888888K.
'Y88b. 888 888 888P' 888P' d8P Y8b '88b 888 888 888 888 'Y88b
'888 888 888 888 888 88888888 .d888888 888 888 888 888 888
Y88b d88P Y88b 888 888 888 Y8b. 888 888 888 888 .d88P 888 d88P
'Y8888P' 'Y88888 888 888 'Y8888 'Y888888 888 8888888P' 8888888P'
SurrealDB command-line interface and server
To get started using SurrealDB, and for guides on connecting to and building applications
on top of SurrealDB, check out the SurrealDB documentation (https://surrealdb.com/docs).
If you have questions or ideas, join the SurrealDB community (https://surrealdb.com/community).
If you find a bug, submit an issue on Github (https://github.com/surrealdb/surrealdb/issues).
We would love it if you could star the repository (https://github.com/surrealdb/surrealdb).
----------
USAGE:
surreal [SUBCOMMAND]
OPTIONS:
-h, --help Print help information
SUBCOMMANDS:
start Start the database server
backup Backup data to or from an existing database
import Import a SQL script into an existing database
export Export an existing database into a SQL script
version Output the command-line tool version information
sql Start an SQL REPL in your terminal with pipe support
help Print this message or the help of the given subcommand(s)
Installing on Windows
The 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.
PS C:\> iwr https://windows.surrealdb.com -useb | iex
Once the script has finished installing, it will tell you where it has installed the SurrealDB command-line tool. If it had the necessary permissions, it will install into /usr/local/bin
, otherwise it will install into your home directory.
.d8888b. 888 8888888b. 888888b.
d88P Y88b 888 888 'Y88b 888 '88b
Y88b. 888 888 888 888 .88P
'Y888b. 888 888 888d888 888d888 .d88b. 8888b. 888 888 888 8888888K.
'Y88b. 888 888 888P' 888P' d8P Y8b '88b 888 888 888 888 'Y88b
'888 888 888 888 888 88888888 .d888888 888 888 888 888 888
Y88b d88P Y88b 888 888 888 Y8b. 888 888 888 888 .d88P 888 d88P
'Y8888P' 'Y88888 888 888 'Y8888 'Y888888 888 8888888P' 8888888P'
Fetching the latest database version...
Fetching the host system architecture...
Installing surreal-v1.0.0-beta.5 for windows-amd64...
SurrealDB successfully installed in:
C:\Users\Tobie\Documents\surreal.exe
To see the command-line options run:
C:\Users\Tobie\Documents\surreal.exe help
To start an in-memory database server run:
C:\Users\Tobie\Documents\surreal.exe start --log debug --user root --pass root memory
For help with getting started visit:
https://surrealdb.com/docs
To check whether the install was successful run the following command in your terminal.
PS C:\> C:\Users\Tobie\Documents\surreal.exe help
The result should look similar to the output below, confirming that the SurrealDB command-line tool was installed successfully.
.d8888b. 888 8888888b. 888888b.
d88P Y88b 888 888 'Y88b 888 '88b
Y88b. 888 888 888 888 .88P
'Y888b. 888 888 888d888 888d888 .d88b. 8888b. 888 888 888 8888888K.
'Y88b. 888 888 888P' 888P' d8P Y8b '88b 888 888 888 888 'Y88b
'888 888 888 888 888 88888888 .d888888 888 888 888 888 888
Y88b d88P Y88b 888 888 888 Y8b. 888 888 888 888 .d88P 888 d88P
'Y8888P' 'Y88888 888 888 'Y8888 'Y888888 888 8888888P' 8888888P'
SurrealDB command-line interface and server
To get started using SurrealDB, and for guides on connecting to and building applications
on top of SurrealDB, check out the SurrealDB documentation (https://surrealdb.com/docs).
If you have questions or ideas, join the SurrealDB community (https://surrealdb.com/community).
If you find a bug, submit an issue on Github (https://github.com/surrealdb/surrealdb/issues).
We would love it if you could star the repository (https://github.com/surrealdb/surrealdb).
----------
USAGE:
surreal [SUBCOMMAND]
OPTIONS:
-h, --help Print help information
SUBCOMMANDS:
start Start the database server
backup Backup data to or from an existing database
import Import a SQL script into an existing database
export Export an existing database into a SQL script
version Output the command-line tool version information
sql Start an SQL REPL in your terminal with pipe support
help Print this message or the help of the given subcommand(s)