# Welcome to Elemento!

# Sign up on Elemento
To get started, click the "*Sign Up*" button at the top right of our [website](https://elemento.cloud) and follow the instructions to **create** an account. Remember to choose a secure password, consisting of at least eight characters, including uppercase and lowercase letters, numbers, and symbols.

## Forgot your password?
**No problem**! If you have forgotten your password, you can easily reset it via the [password recovery link](https://portal.elemento.cloud/password_recovery). Follow the provided instructions and you will be able to access your account again.

# Installation of Elemento Software

## Elemento **ElectrOS** App:
Download our app [Electros](https://www.elemento.cloud/electros-download).

:::danger
Electros requires *git* to be installed on the machine!
:::

#### Elemento Daemons
You can download the Daemons directly through the ElectrOS app.

## Install AtomOS on your private servers

### From an existing rhel compliant installation (Rockylinux or Almalinux)

`sudo bash -c "curl https://repo.elemento.cloud/get-atomos.sh | bash"`

<!-- ### From our ISO
If you haven't installed AtomOS on your device yet, you can easily do so by downloading its live ISO version from [this link](https://repo.elemento.cloud/iso/AtomOS.iso). If you prefer a version without a graphical interface, you can opt for [this alternative ISO](https://repo.elemento.cloud/iso/AtomOS-headless.iso). Once you have downloaded the file, follow the instructions to burn it to a USB stick or DVD, then boot the computer from this media. If you have any doubts on how to do this, don't hesitate to ask a more experienced friend or family member for help. -->

## AtomOS License

AtomOS is provided as a single .iso file that can act as a free version or become a licensed professional version, depending on the presence of a valid paid license.
The licenses will be associated with your Elemento account: since the association will be done using the email address as the key, during the purchase process **always remember to use an email address associated with a valid Elemento account**.

To purchase one or more AtomOS licenses, visit [this page](https://buy.stripe.com/7sIg1t2Aj8JOgb6003) and complete the purchase process.


:::success
Remember: annual plans can save you 20%!
:::

Once the purchase is processed, you will receive your new license directly in your ElectrOS app.
Go to the Licenses page to view your copies of AtomOS.


Licenses with a gray *Activated* button are already in use.
Licenses with a green *Activate* button can be enabled by clicking on it.
After clicking, an additional section will appear, showing the license's cryptographic key. Do not close the section or the app as this information will only be shown once.


As suggested by the prompt, copy the entire contents of the gray box into the file `/etc/elemento/atomos.license` on the running AtomOS instance for which you are activating the license.

:::info
Are you using the *demo* cluster? Don't worry, licenses are on us.
Since licenses are server-side, you will not see anything there unless you purchase some licenses.
:::

### Storages
:::info
Volumes will be searched in `/mnt/`, mount here your volumes!

Every path with a *settings.json* file will be used to create volumes.

{
    "max-volumes": 10,
    "max-size": 1000
}

If you just installed AtomOS a *settings.json* file is waiting for you in */mnt*
:::

## Security Certificates
To ensure secure connections via HTTPS to AtomOS services, we recommend downloading the Elemento authority certificate from [this repository](https://github.com/Elemento-Modular-Cloud/elemento-ca). Follow the provided instructions for installation.

# Demo setup
During the demo you will:
- Install tailscale
- Install ElectrOS or use the webapp
- Play and enjoy our next-gen hypervisor!
- Send some feedback with [this form](https://vjueyfz5.forms.app/bug-report-form)

:::info
In order to make the Demo Day run as smooth as possible we kindly suggest you to perform all preparatory steps before the actual Demo Day date.

We are more than welcome to setup an onboarding call for the Demo Day morning to guide you through the setup fase.
Get in touch at least 3 days before the Demo Day to make sure we can setup the onboarding call!
:::

## VPN to access our cluster
### Download the Tailscale app
Download the **Tailscale** app

- Download the WireGuard app for **Windows** from this link:
https://pkgs.tailscale.com/stable/tailscale-setup-latest.exe

(Follow these steps https://headscale.net/windows-client/)

:::info
*<YOUR HEADSCALE URL>* should be set to https://vpn.elemento.cloud
:::

- Download the WireGuard app for **MacOS** from this link:
https://apps.apple.com/it/app/tailscale/id1475387142?l=en-GB&mt=12

(Follow these steps https://vpn.elemento.cloud/apple)

- On Linux, run this command
`curl -fsSL https://tailscale.com/install.sh | sh`

#### Access the VPN
From a terminal, run `tailscale up --login-server=https://vpn.elemento.cloud --accept-routes`

You will see a message like this:

Send a copy of this to [e-mail] to get authorized!

## Web app

:::info
**Fast way to the demo without installing anything!**
:::

If you are unable or worried about downloading our app, you can use a demo app available at [http://192.168.5.8:3000/](http://192.168.5.8:3000/)

Simply open [http://192.168.5.8:3000/](http://192.168.5.8:3000/) in your favourite browser!

## ElectrOS
### Download
#### Elemento ElectrOS App:
Download our app [Electros](https://www.elemento.cloud/electros-download).

:::danger
Electros requires *git* to be installed on the machine!
:::

### Set hosts
Add these IPs to $HOME/.elemento/hosts
:::warning
$HOME is your user folder, depending on your operating system it might look like this:
- /Users/User/
- C:\Users\User
- /home/user/electros/client
:::

- 192.168.5.201
- 192.168.5.202
- 192.168.5.200
- 192.168.5.205

### Settings
You can set some settings in $HOME/.elemento/settings

:::success
You can configure

{
    "useTCPList": true,
    "useDiscovery": false
}

:::

- "useTCPList": set it to **true** to use the IPs in *hosts*
- "useDiscovery": set it to **false** unless you have licensed machines in your LAN.

# Demo Steps
Open the app

Download and launch the services

Log in

View your VMs

And your storage

Check for activatable licenses

#### Activate a License


#### Create a VM

You can choose to use a template (Automagic) or create your own configuration


##### Basic Mode

##### Advanced Mode


Check cloud costs

RAM

Choose the operating system


Choose your storage

Add a GPU and other PCI devices

:::danger
Remember to also add the audio cards!
For example, if you add an A4000, you will need to add its audio card *GA104 High Definition Audio Controller*.

If you choose the AMD WX2100, add its audio card *Baffin [Radeon RX 550 640SP / RX 560/560X]*.
:::info
If you are using the demo, try adding an *NVIDIA A4000* card or an *AMD Radeon PRO WX 2100* GPU.
:::

Choose your cloud provider or select *AtomOS* to use *private* resources.

List your VMs

:::success
Did you notice that some VMs can be on cloud providers?
:::

Attach multiple VMS

:::warning
Your machine will have 2 network interfaces:
- the first one is the real one giving you access to the internet
- the second one should be configured with an IP in the network *192.0.0.0/24* and all your VM will be **able to reach each other**
:::

Use a VM in the browser


:::danger
This feature requires the VM to have an internet connection, wait until you see the IP address in the *Network* column.
:::info
In the demo mode try *elemento*:*0000* as credentials
:::

# Sysadmin

If you open [https://IP:9090](https://192.168.5.205:9090) you can connect to the sysadmin interface!


:::info
On the demo cluster, you can use the credentials *demo*:*demo*

Try:
- [https://192.168.5.200:9090](https://192.168.5.200:9090)
- [https://192.168.5.205:9090](https://192.168.5.205:9090)

:::danger
Be sure to disable the *Limit acces* button in the upper right corner (the password is *demo* as before).

:::

# Feedbacks and suggestions

Is there something you wanna to tell us?

Feel free to [complete this form](https://vjueyfz5.forms.app/bug-report-form) with any positive/negative feedback you have about any of the steps!

## Need Help?
If you have any questions or concerns during this process, do not hesitate to contact us by opening an issue in our [help center](https://github.com/Elemento-Modular-Cloud/helpcenter). Our team will be happy to assist you and resolve any problems you may encounter.

:::danger
Open a ticket on our [**help center**](https://github.com/Elemento-Modular-Cloud/helpcenter)
:::

Thank you for choosing Elemento! We hope you enjoy our services to the fullest.