There are two paths to spin up a GQLDB instance:
However you launched it, you can connect to it with Ultipa Manager, a visual tool for managing your database and running queries, or with the Ultipa CLI, a command-line client.
Open your terminal and run the GQLDB installer for your platform.
macOS / Linux (in a terminal):
Bashcurl -fsSL https://download.ultipa.com/gqldb/install.sh | sh
Windows 10/11 (in PowerShell):
Powershellirm https://download.ultipa.com/gqldb/install.ps1 | iex
Then verify the installation:
Bashultipa-gqldb -version
On macOS, if the first run fails with a Gatekeeper quarantine error, clear the attribute: xattr -d com.apple.quarantine "$(command -v ultipa-gqldb)" 2>/dev/null
Create a database:
Bash# Create a project directory and enter it mkdir my-gqldb cd my-gqldb # Create a database ultipa-gqldb -db ./my.gdb -rbac -admin-pass myPassword -port 60061
The database instance immediately runs on localhost:60061. It runs in the foreground, so its logs stream in this terminal, that is normal and means the server is up. Keep this terminal open (closing it, or pressing Ctrl+C, stops the server). To keep it running in the background instead, launch it with nohup.
A few things worth knowing:
my.gdb in your current folder.admin / myPassword.default graph, and you may create one more graph. Each graph has up to 1M nodes and 1M edges, plenty for most demo projects.To connect to the database and run queries with a visual tool, download the GQLDB Manager desktop app from the Download Center, choosing the build for your platform (macOS, Linux, or Windows). Open it, add a new connection to your local instance with host localhost, port 60061, and the admin / myPassword credentials, then save and open the connection.
On macOS, the desktop app is not yet notarized, so the first launch may be blocked by Gatekeeper (a "GQLDB Manager" can't be opened / is damaged message). Right-click the app in Applications and choose Open, then confirm; or clear the quarantine attribute from a terminal: xattr -dr com.apple.quarantine "/Applications/GQLDB Manager.app".

For a database on your computer, run desktop Manager on that computer and connect to localhost. Desktop Manager can also connect to another host reachable from your computer. The cloud-hosted Manager connects from Ultipa's servers, so entering localhost there points at the cloud server rather than yours. For a hosted endpoint, you can open cloud-hosted Manager and sign in or register; the database must be reachable from that service.
See GQLDB Manager for download steps, connection troubleshooting, and a small example you can visualize immediately.
Alternatively, use the Ultipa CLI, available from the same Download Center for macOS, Linux, and Windows:
Bashgqldb-cli -h localhost:60061 -u admin -p myPassword -g default
That opens an interactive shell. Every GQL statement in this and the following chapters runs in it unchanged.
Create a fully-managed GQLDB instance on Ultipa Cloud, with nothing to install:
xxx.dbaas.ultipa.com:443) and credentials (admin and a password you can copy) under Connection Info.
Copy the password and click Connect to Manager; Ultipa Manager opens in a new tab. The first time, you will be prompted to add the connection. All fields are auto-filled except the password, paste it and click Save:

You will see the connection card added, with a green status indicator next to the connection name. Click the card to enter the connection.
In Manager's query editor, or in the CLI shell, run the following GQL statement to check your database version:
GQLRETURN db.version()

You have a running instance and a client that can reach it. Next, put some data in it: Load Your Data.