Someone runs a Zomg instance and gave you an account. This page gets the zomg CLI installed, pointed at that instance, and signed in.

​
Install

curl -fsSL https://zomg.ai | sh
The installer puts zomg in ~/.local/bin; make sure that directory is on your PATH.

​
Point at your instance

Get the domain from whoever runs your instance, then: 
zomg use zomg.ai
This probes https://api.zomg.ai (then https://zomg.ai), saves the instance as a runtime target named after the domain — for example loop.work — and makes it the default. It also works with an explicit API URL: 
zomg use https://api.staging.example.com
If your instance can’t be probed this way, add the target by hand with zomg target add <name> --api-url <url> --current. Working with more than one instance? zomg target list shows them all, zomg use <name> switches the default, and zomg target remove <name> deletes one.

​
Sign in

zomg auth signin
This opens a browser Google sign-in when your instance has it enabled and stores the token on the current target. For scripts and agents, zomg auth token prints the stored token. Signing in also makes you you everywhere: your first sign-in provisions a deployment user from your email, and zomg exec, zomg console, and zomg ssh run as that user with the same /home/<user> in every box. Pass --root when you explicitly need a root session. See Environment → Users.

​
Check the connection

zomg health
It should report the API version and status.

​
Stay current

zomg upgrade
This installs the CLI version your instance’s API serves, so client and server stay in step.

​
Next

Create your first box: Quickstart.