<p style="text-align: center"><b><font size=5 color=blueyellow>Login to LUMI Cluster</font></b></p>

**Contribution**: <a><img src="https://img.shields.io/badge/ENCCS-blue?style=plastic"/></a>

**Categories**: <a><img src="https://img.shields.io/badge/Blogpost-996300?style=plastic"/></a> <a><img src="https://img.shields.io/badge/LUMI-green?style=plastic"/></a> <a><img src="https://img.shields.io/badge/MyAccessID-3232ff?style=plastic"/></a> <a><img src="https://img.shields.io/badge/SSH key-aqua?style=plastic"/></a>

:::warning
**If you are have an CSC account, you need to follow the procedures in the link below to link your existing accounts**: https://docs.csc.fi/accounts/how-to-manage-user-information/#how-to-link-your-csc-user-account-to-external-authentication-sources
:::

**Contents of this document and quicklinks**：
[TOC]

## 1. Receive an invitation email from LUMI

After we add you to one project on LUMI, you will automatilly get an email with following information:

This is a message from your LUMI supercomputer self-service portal
(my.lumi-supercomputer.eu).

XXX has invited you to join LUMI-C and LUMI-G for training purposes (XXX) project.

Please visit the link below to sign up and accept your invitation:
https://my.lumi-supercomputer.eu/invitation/xxxxxxxxxx/

<font color=red>**Note: this invitation has an expired date, please manage your access as soon as possible**</font>

---

## 2. Registration at **MyAccessID**

In order to access the portal, you need to register at MyAccessID. This procedure can be achieved via the Sign in with MyAccessID.

**==[HERE](https://puhuri.neic.no/user_guides/myaccessid_registration/)==** are the detailed procedures for you to register at **MyAccessID**.

---

## 3. Generate a local SSH key pair for your local computer

If you want to use LUMI from a terminal, you need to register an SSH key pair. The SSH keys are the only way to connect to LUMI when using a Linux, macOS or Windows PowerShell terminal, or MobaXterm or PuTTY from Windows. There is no option for using passwords.

> LUMI only accepts SSH keys based on the `RSA (4096 bit)` or `ed25519` algorithms. If possible, we recommend to use `ed25519`.

**==[HERE](https://docs.lumi-supercomputer.eu/firststeps/SSH-keys/)==** are instructions generate an appropriate SSH key pair from your computer.

---

## 4. Register your ==public== SSH key at MyAccessID

- Login to [**MyAccessID profile management page**](https://mms.myaccessid.org/fed-apps/profile/)
- Click `Settings` from the left-side menu.
- 

- Click on `SSH Keys` MyAccessID settings
- Click on `New Key` and then add the ==**public**== part of your SSH key and save the key by clicking `Add SSH key`
- 
- Wait 1-2 hours for the key to propagate to the cluster

---

## 5. Login to LUMI via terminal

In the next few hours you will receive emails with your LUMI **username** and project access information.

You can access to LUMI using the command below via terminal.

ssh -i <path-to-private-key>/id_ed25519 <username>@lumi.csc.fi

> If you set the passphrase for key `id_ed25519` when you generate the SSH key, you will be asked to enter the passphrase for the SSH key.

If everything goes well, you will see the info on your terminal.


---

## 6. Login to LUMI via Web Interface

You can also login to LUMI via [web interface](https://www.lumi.csc.fi/public/). Click the `Go to login` button and you will come to the webpage with `pinned apps`.


### 6.1 `Login node shell`

Click the `Login node shell` button and you can login to LUMI via the web browser. You can also change the theme of through the button on the upper right corner.


### 6.2 `Home Directory`

Click the `Home Directory` button and you can come to the webpage like this


In this webpage, you can open a terminal, create files and new directories. You can also upload files from local computer to LUMI, and download files from LUMI to your local computer.

### 6.3 Other IDEs

You can also use other IDEs for your project, for example, the VS Code and Jupyter notebook for your project using Python and Julia for programming.

:::danger
:::