Quick start

This guide walks you through installing the edge CLI, logging in, and deploying your first service.

1. Install the CLI

brew install simplifyd-systems/tap/edge

go install github.com/simplifyd-systems/cloud-cli/cmd/edge@latest

git clone https://github.com/simplifyd-systems/cloud-cli
cd cloud-cli
make install   # runs go install

Verify the installation:

edge --version

2. Log in

edge auth login

You will be prompted for your email and password. The token is saved to ~/.simplifyd/config.json and reused automatically for every subsequent command.

For CI/CD pipelines, skip interactive login and pass a token via an environment variable instead:

export CLOUD_TOKEN=<your-token>

3. Set your context

Select the workspace, project, and environment you want to work with:

edge workspace use my-workspace
edge project use my-project
edge env use production

Or, if you work from a specific directory, run edge link once to pin the context to that directory tree:

cd ~/code/my-app
edge link

From that point on, every edge command run inside ~/code/my-app (or any subdirectory) will automatically target the linked workspace, project, and environment.

4. Deploy a service

Create a service and deploy it:

# Create a Docker service
edge service create --name api --type docker --image nginx --tag latest

# Deploy it
edge deploy up api

Watch the live logs:

edge deploy logs api --follow

5. Add environment variables

edge variables set DATABASE_URL=postgres://... API_KEY=secret123

Next steps