Launch Resoto

Resoto allows you to manage and explore your cloud infrastructure via a web or shell interface.

Resoto UI

Resoto UI is a user-friendly web interface that simplifies managing and exploring your cloud infrastructure.

The steps to launch Resoto UI are dependent on how you installed Resoto.

AWS

1. Log in to the AWS CloudFormation console.

2. Click Stacks.

3. Enter ResotoEKS into the search box, and click on the ResotoEKS stack.

   

4. Click the Outputs tab.

5. Enter ResotoUI into the search box. There should be exactly one entry. Copy the value (e.g., https://a3xxxxxx.us-east-1.elb.amazonaws.com:8900).

   info

   The value of ResotoEKS.ResotoUI in Outputs is the URL of the Resoto UI.

6. Open the copied URL in your browser.

   note

   The SSL certificate is self-signed, but you can safely ignore any browser warnings.

7. Log in with your Resoto credentials:

   

   note

   If accessing a new Resoto install, you will be prompted to create an administrator account:

   

   Additional users can be added via the CLI using the user add command.

   See User Management for details.

8. After logging in, Resoto UI will start.

   note

   The first time Resoto UI is launched, a setup wizard will appear to help you configure Resoto:

   

DigitalOcean

1. Resoto is available via an externally accessible service address. Get the address by executing the following in your terminal:

   export SERVICE_ADDRESS=$(kubectl get --namespace resoto service resoto-resotocore -o jsonpath="{.status.loadBalancer.ingress[0].ip}")
   echo "Visit https://$SERVICE_ADDRESS:8900 to use Resoto."

2. Copy the URL into your browser to launch Resoto UI.

   note

   The SSL certificate is self-signed, but you can safely ignore any browser warnings.

3. Log in with your Resoto credentials:

   

   note

   If accessing a new Resoto install, you will be prompted to create an administrator account:

   

   Additional users can be added via the CLI using the user add command.

   See User Management for details.

4. After logging in, Resoto UI will start.

   note

   The first time Resoto UI is launched, a setup wizard will appear to help you configure Resoto:

   

   

Docker

1. Resoto UI listens on port 8900 by default. You can access it by opening https://localhost:8900 in your browser.

   note

   The SSL certificate is self-signed, but you can safely ignore any browser warnings.

2. Log in with your Resoto credentials:

   

   note

   If accessing a new Resoto install, you will be prompted to create an administrator account:

   

   Additional users can be added via the CLI using the user add command.

   See User Management for details.

3. After logging in, Resoto UI will start.

   note

   The first time Resoto UI is launched, a setup wizard will appear to help you configure Resoto:

   

   

Kubernetes

1. Resoto provides a service that exposes Resoto UI on port 8900. We recommend configuring an Ingress with a valid certificate for UI access, but you can port-forward the service as a temporary solution:

   $ kubectl port-forward services/resoto-resotocore 8900

2. Log in with your Resoto credentials:

   

   note

   If accessing a new Resoto install, you will be prompted to create an administrator account:

   

   Additional users can be added via the CLI using the user add command.

   See User Management for details.

3. After logging in, Resoto UI will start.

   note

   The first time Resoto UI is launched, a setup wizard will appear to help you configure Resoto:

   

   

pip

1. Resoto UI listens on port 8900 by default. You can access it by opening https://localhost:8900 in your browser.

   note

   The SSL certificate is self-signed, but you can safely ignore any browser warnings.

2. Log in with your Resoto credentials:

   

   note

   If accessing a new Resoto install, you will be prompted to create an administrator account:

   

   Additional users can be added via the CLI using the user add command.

   See User Management for details.

3. After logging in, Resoto UI will start.

   note

   The first time Resoto UI is launched, a setup wizard will appear to help you configure Resoto:

   

   

Resoto Shell

Resoto Shell is Resoto's command-line interface.

The steps to launch Resoto Shell depend on how you installed Resoto.

AWS

1. Log in to the AWS CloudFormation console.

2. Click Stacks.

3. Enter ResotoEKS into the search box, and click on the ResotoEKS stack.

   

4. Click the Outputs tab.

5. Enter ResotoEKSConfigCommand into the search box. There should be exactly one entry. Copy the value (aws eks ...).

   

   info

   The value of ResotoEKS.ResotoEKSConfigCommandXXXX in Outputs is a command to configure kubectl to connect to the EKS cluster.

6. Open a terminal and execute the copied command.

   

7. Execute the following in the terminal to access the Resoto Shell interface:

   $ kubectl exec -it service/resoto-resotocore -- resh

DigitalOcean

Execute the following to access the Resoto Shell interface:

kubectl --namespace resoto exec -it service/resoto-resotocore -- resh

Docker

Execute the following to access the Resoto Shell interface:

$ docker exec -it resotoshell resh

Kubernetes

1. Make sure that the deployment is available:

   $ kubectl wait --for=condition=available deployment/resoto-resotocore

2. Execute the following to access the Resoto Shell interface:

   $ kubectl exec -it service/resoto-resotocore -- resh

pip

Execute the following to access the Resoto Shell interface:

$ resh