Getting started

This guide helps you set up your evroc account and start using evroc cloud services.

Prerequisites

To use the evroc cloud, you need:

An evroc organization for your company
At least one user account associated with that organization

Visit evroc.com to sign up or contact evroc support for account setup. You'll receive an email with your username and temporary password once your account is ready.

Log in to the console

The evroc console provides a web interface for managing your cloud resources.

Navigate to the console
Enter your username and temporary password
Follow the prompts to set a new password
Log in with your new credentials

The console dashboard shows an overview of your resources and provides access to all evroc services. From here, you can create virtual machines, manage storage, and configure networking.

Choose your workflow

evroc supports multiple ways to interact with the platform. Choose the approach that best fits your needs:

Console (recommended for getting started)

The console provides a visual interface for managing resources. This is the easiest way to get started, especially for:

Creating your first virtual machines
Exploring available services
Learning about evroc's features

CLI (for automation and scripting)

The evroc CLI enables command-line access to all evroc services. Install the CLI if you need to:

Automate resource creation and management
Integrate evroc into your existing scripts
Work from terminal environments

See Install the evroc CLI for setup instructions.

REST API (for advanced automation)

The evroc platform exposes a REST API for direct programmatic access. Use the API when you need:

Integration with your infrastructure-as-code tools
Custom automation beyond what the CLI provides
Direct control over resource specifications

See the API reference documentation for each product for details.

To use the API, a valid access token needs to be sent in the header Authorization: Bearer {token} in every request. To get this token, you can:

Authenticate using the evroc CLI: log in using evroc login command. Once authenticated, you can retrieve a fresh access token by running the command evroc iam get-access-token.
Use this one-liner python command below to mimic the OIDC authorization code flow. Run it in your terminal to authenticate to your evroc account and get an access token:

python3 -c "import http.server, socketserver, urllib.parse, sys, subprocess, webbrowser, json
# Bind to port 0 to let OS assign an available port automatically
class H(http.server.SimpleHTTPRequestHandler):
    def do_GET(self):
        # Extract authorization code from callback URL query parameters
        c=urllib.parse.parse_qs(urllib.parse.urlparse(self.path).query).get('code',[None])[0]
        # Get the actual port assigned by OS from the server instance
        p=self.server.server_address[1]
        # Send HTTP 200 response to browser
        self.send_response(200); self.end_headers()
        self.wfile.write(b'Login OK. The access token will be printed in your terminal. You can close this window.')
        # Exchange auth code for access token via POST request
        r=subprocess.run(['curl','-s','-X','POST','https://authn.iam.evroc.com/realms/evroc-customer/protocol/openid-connect/token','-H','Content-Type: application/x-www-form-urlencoded','-d','grant_type=authorization_code','-d','client_id=evroc-cli','-d',f'code={c}','-d',f'redirect_uri=http://localhost:{p}/redirect'],capture_output=True,text=True)
        # Pretty print JSON token response or raw output if parsing fails
        try: print(json.dumps(json.loads(r.stdout),indent=2))
        except: print(r.stdout)
        sys.exit(0)
# Start server on random available port (port 0)
with socketserver.TCPServer(('',0),H)as s:
    p=s.server_address[1]  # Retrieve the assigned port number
    print(f'Listening on port:{p}')
    # Launch browser to initiate OAuth flow
    webbrowser.open(f'https://authn.iam.evroc.com/realms/evroc-customer/protocol/openid-connect/auth?client_id=evroc-cli&response_type=code&redirect_uri=http://localhost:{p}/redirect&scope=openid')
    s.handle_request()"

Please note that access tokens are valid for 5 minutes, after which you need to generate a new one.

Coming soon: the official Go SDK is in the making and it will make programmatic access to the API easy and straightforward.

Next steps

Now that you're set up, explore evroc services:

For help, see the Support page or contact evroc support.

evroc User Documentation