Getting started with evroc's cloud

Welcome to evroc's cloud. This document tells you how to get set-up for using evroc's cloud

Pre-requisites

In order to get started with evroc's cloud you will need:

  • An organization set up for your company or organisation
  • At least one user tied to this organization

Contact evroc support in order to get this set up.

Once this is done you will receive an email from evroc with your users and initial passwords.

First time set-up

Logging in with a user for the first time

Once you have your user and temporary password, you will need to change it.

You can do this by navigating to evroc's web console, entering your username and password and logging in. This will prompt a password reset and log you in.

Logging into evroc's cloud

Downloading the evroc CLI

You can download the evroc CLI for macOS (under darwin_<arch>/), Linux, or Windows from https://downloads.evroc.com/evroc-cli/latest/.

For Linux machines, you can simply run

wget https://downloads.evroc.com/evroc-cli/latest/linux_$(dpkg --print-architecture)/evroc

For Windows machines, the Edge browser may ask you to "make sure you trust evroc.exe before you open it." This is expected, and you can safely agree to keep it.

You may want to add the binary to your PATH. You may also want to set up shell completions.

Running the evroc CLI

The CLI must be run from the command line (e.g. ./evroc or .\evroc.exe). Throughout the docs, we use evroc as a shorthand for running ./evroc or .\evroc.exe, depending on your platform.

Logging in using the evroc CLI

When logging in with the evroc CLI, you will be re-directed to the evroc authentication service to login.

If this is the first time you are logging in you will need to set a new password, and set up one-time password (TOTP) token authentication. Your initial password will be provided in email by the evroc team on request.

$ evroc login
[1/3] Logging in to evroc...
open the following link in your browser: https://authn.prod.evroclabs.net/...
[2/3] Creating or updating kubeconfig...
[3/3] Done!

The login will create a kubeconfig file ~/.evroc/config.yaml with a context you can use to interact with the service using kubectl.

Next run evroc compute virtualmachine list to check that you are connected successfully.