These CLI commands require CLI version 3.0 or later.
In addition to managing your own local and remote instances, the EdgeDB CLI offers tools to manage your instances running on our EdgeDB Cloud.
Authenticate to the EdgeDB Cloud and remember the access token locally
Forget the stored access token
Manage your secret keys
To use the CLI with EdgeDB Cloud, start by running edgedb cloud login. This will open a browser and allow you to log in to EdgeDB Cloud.
During the Cloud beta, you will only be able to successfully complete authentication if you have been invited to the beta.
Once your login is complete, you may use the other CLI commands to create and interact with Cloud instances. To create an Cloud instance, you can use one of these commands:
edgedb instance create with an instance name of
edgedb instance create <github-username>/<instance-name>
edgedb project init with the
--server-instance option. Set
the server instance name to
edgedb project init \ --server-instance <github-username>/<instance-name>
Alternatively, you can run
edgedb project init
--server-instance option and enter an instance name in the
<github-username>/<instance-name> format when prompted interactively.
Please be aware of the following restrictions on EdgeDB Cloud instance names:
can contain only Latin alpha-numeric characters or
cannot start with a dash (
-) or contain double dashes (
maximum instance name length is 61 characters minus the length of your GitHub username (i.e., length of GitHub username + length of instance name must be fewer than 62 characters)
For your production deployment, generate a dedicated secret key for your instance with edgedb cloud secretkey create. Create two environment variables accessible to your production application:
EDGEDB_SECRET_KEY- contains the secret key you generated
EDGEDB_INSTANCE- the name of your EdgeDB Cloud instance