---
title: Organizations and Projects - Quickstart
description: This page shows you how to get started with Scaleway Organizations and Projects.
tags: project ssh-key api-key putty organizations
dates:
  validation: 2025-10-01
  posted: 2021-05-26
---
import Requirements from '@macros/iam/requirements.mdx'

import image from './assets/scaleway-terminal-icon.webp'
import image2 from './assets/scaleway-puttygen-app.webp'
import image3 from './assets/scaleway-puttygen-01.webp'
import image4 from './assets/scaleway-puttygen-02.webp'
import image5 from './assets/scaleway-puttygen-03.webp'


When you [create a Scaleway account](/account/how-to/create-an-account/), an Organization, of which you are the [Owner](/iam/concepts/#owner), is created for you.

An Organization is made of one or several [Projects](/organizations-and-projects/concepts/#project) that contain your resources. This page helps you get started with using Projects and managing your resources.

## How to generate an SSH key

To establish connections with Instances, Elastic Metal servers, and Mac minis, you must generate an SSH key for your Project. Creating and uploading the SSH key to your Project before resource creation has the advantage of prompting you to associate the uploaded SSH key with the resource during the creation process. This simplifies the management of SSH access for you.

<Requirements />

- A Scaleway account logged into the [console](https://console.scaleway.com)
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization

[SSH keys](/organizations-and-projects/concepts/#ssh-key) allow you to securely connect to your Instances without using a password.

You can generate the SSH key pair on your local machine. The process will depend on your operating system.


### How to generate an Ed25519 SSH key pair on macOS and Linux

On macOS and Linux, you can generate the SSH key pair directly from the terminal.

1. Open the terminal application by clicking on the corresponding icon.
    <Lightbox image={image} alt="Terminal Icon" />
2. Type the following command and press **Enter** to generate a new key:
    ```bash
    ssh-keygen -t ed25519 -C "login@example.com"
    ```
    <Message type="important">
        It is strongly recommended to use [Ed25519](https://en.wikipedia.org/wiki/EdDSA#Ed25519) for increased security and performance. If you cannot use Ed25519 keys, you can create an RSA4096 key as a fallback option:
        ```bash
        ssh-keygen -o -b 4096 -C "login@example.com"
        ```
    </Message>
3. When prompted to enter a file path in which to save the key, either specify a path or press **Enter** to accept the default location (`~/.ssh/id_ed25519`).
    ```
    Enter file in which to save the key (~/.ssh/id_ed25519):
    ```
4. Enter a passphrase when prompted. This step is optional but recommended for increased security. If you do not want to set a passphrase, press **Enter** directly.
    ```
    Enter passphrase (empty for no passphrase):
    ```
5. Confirm the passphrase by entering it again when prompted, and press **Enter**:
    ```
    Enter same passphrase again:
    ```

    The key pair will be generated in the specified filepath. The key pair consists of:
    - The public key, named `id_ed25519.pub`
    - The private key, named `id_ed25519`
    <Message type="important">
      Ensure that the private key file (`<key_name>`) is kept secure. Do not share it with unauthorized parties. You can set appropriate permissions on the file to restrict access using the following command:
      ```bash
      chmod 600 <key_name>
      ```
    </Message>
6. Display the content of the public key with the following command and copy it:
    ```bash
    cat ~/.ssh/id_ed25519.pub
    ```
7. Copy the content of the public key displayed. You will need this in the next step. It should look something like this:
    ```
    ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAINPZxtCMs5sIfsMWpq7SHuqFFpBtSTmFqXWOYdf6dX4i login@example.com
    ```

### How to generate an Ed25519 SSH key pair on Windows

On Windows, you can use the third-party application [PuTTYgen](https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html) to generate an SSH key pair.

1. Download and install [PuTTY](https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html) on your local computer. The **PuTTYgen** application is automatically installed along with the main PuTTY application.
    <Lightbox image={image2} alt="PuTTYgen App" />
2. Launch PuTTYgen by double-clicking the application icon.
3. Select **EdDSA** and click the **Generate** button. You can also add a passphrase before generating the key to increase security.
    <Lightbox image={image3} alt="PuTTYgen Generate Key" />
4. Move the mouse around the blank area as instructed to generate randomness.
    <Lightbox image={image4} alt="PuTTYgen Randomness" />

    The public and private key are generated, and the following screen will display:
    <Lightbox image={image5} alt="PuTTYgen Keys Generated" />
5. Complete the steps on the screen to finish:
    - Fill in the **Key comment** field with a name to help you identify this key pair.
    - Click the **Save public key** button and save it in the folder of your choice.
    - Click the **Save private key** button to save it in the same folder.
        <Message type="important">
            Ensure that the private key file (`<key_name>`) is kept secure. Do not share it with unauthorized parties.
        </Message>
    - Select the content of the public key (the sequence of characters under "Public key for pasting into OpenSSH authorized_keys file") and copy it, as you will need this in the next step.

### How to upload the public SSH key to your Scaleway Project

You must upload the content of the public part of the SSH key pair you just created to the Scaleway interface. This is then associated with your Project and can be transferred to your Instances during the boot process.

1. From the [Scaleway console](https://console.scaleway.com), navigate to the [Credentials](/organizations-and-projects/concepts/#ssh-key) tab of your Project dashboard.
2. Scroll down to the **SSH key** section, and click **Add a new SSH key**.
3. Paste the content of the public key (which you copied in the previous step) into the pop-up box, and optionally add a description. Then click **Add an SSH key**.

    You will now be able to [connect to your Instances via SSH](/instances/how-to/connect-to-instance/)

## How to add resources to your Project

To add a new [resource](/iam/concepts/#resource) to your Project, first ensure you are currently editing the correct Project.

1. Click **Project Dashboard** in the [Scaleway console](https://console.scaleway.com) side menu to check if you are logged in the correct Project.
2. You can also check if the name of your Project appears in the **Selected Project** drop-down menu.
3. Select the resource you want to create from the console side menu.
4. Click the resource and follow the deployment instructions.

    Once the resource is created, it is automatically included in your Project.