=== 🔐 How to Get Access to the Cluster ===

To gain access to the cluster, follow the steps below to generate an SSH key and send it to the administrators.

=== 🖥️ Step 1: Generate an SSH Key Pair ===
====🔷 Linux / macOS ====
Open your terminal.

Run the following command:

<code bash>
ssh-keygen -t ecdsa -b 521  -C "your_email@example.com"
#Press Enter to accept the default file location (~/.ssh/id_ecdsa).
#(Optional) Set a passphrase for added security.
</code>

This will generate:

~/.ssh/id_ecdsa (your private key)

~/.ssh/id_ecdsa.pub (your public key)

====🟦 Windows (using PowerShell or Git Bash)====
**Option 1**: Git Bash (Recommended)
Install Git for Windows if you don’t have it.

Open Git Bash and run:

<code bash>
ssh-keygen -t ecdsa -b 521  -C "your_email@example.com"
#Accept the default location (/c/Users/YourName/.ssh/id_ecdsa) and set a passphrase if desired.
#(Optional) Set a passphrase for added security.
</code>


**Option 2**: PowerShell (with OpenSSH)
Open PowerShell (Run as Administrator).

Run:
<code powershell>
ssh-keygen -t ecdsa -b 521 -C "your_email@example.com"
# Press Enter to use the default save path (C:\Users\YourName\.ssh\id_ecdsa).</code>
</code>


====📤 Step 2: Send Your Public Key====
Find your public key:

**Linux/macOS:** ~/.ssh/id_ecdsa.pub

**Windows:** C:\Users\YourName\.ssh\id_ecdsa.pub (or in Git Bash: ~/.ssh/id_ecdsa.pub)

Send it via email to: 📧 admin@unite.cluster

====✅ Step 3: Wait for Confirmation====
The administrators will create your cluster account and add your SSH key. You’ll receive login details once setup is complete.

====🔌 Step 4: Connect to the Cluster====
After you’re granted access, connect to the cluster with:
  * **Windows** (using [[ https://mobaxterm.mobatek.net/ | MobaXterm ]]). Open MobaXterm.

    - Click "Session" in the top-left corner.
    - In the Session settings window, select SSH.
    - In the Remote host field, enter the cluster address (e.g., storage1.unite.uni-sofia.bg).
    - In the Specify username field, enter your cluster username.
    - Under the "Advanced SSH settings" tab, click "Use private key" and browse for the private key file you saved earlier (e.g., id_ecdsa).
    - Click "OK" to save the session.

  * **Linux**
    - Create configuration file in ~/.ssh/config 
      <code bash>
        Host unite.uni-sofia.bg
        HostName storage2.unite.uni-sofia.bg
        User <your_username>
        IdentityFile ~/.ssh/id_unite
      </code>