---
title: How to create secrets with Secret Manager
description: Discover how to efficiently create secrets using Scaleway's Secret Manager. Follow these step-by-step instructions whether you are setting up your first secret or adding more to your existing resources.
tags: secret sensitive-data storage-system secret-type
dates:
  validation: 2025-06-17
  posted: 2023-02-21
---

The [secret](/en/docs/secret-manager/concepts/#secret) creation process slightly differs depending on whether you are using Secret Manager for the first time or not. Upon secret creation, you are prompted to choose a Scaleway-managed encryption key or specify an existing [Key Manager](/en/docs/key-manager) key which will encrypt your data. This allows for secure and flexible encryption of your data, compliant with industry standards.

This page explains how to create a [secret](/en/docs/secret-manager/concepts/#secret) for the first time using the [Scaleway console](https://console.scaleway.com) and how to create a secret if you have already created resources in Secret Manager.

## Before you start

To complete the following actions, you must have:

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

**Create your first secret**

1. Click **Secret Manager** in the **Security & Identity** section of the [Scaleway console](https://console.scaleway.com/) side menu.

2. In the **Region** drop-down, select the [region](/en/docs/secret-manager/concepts/#region) in which you want to store your secret.

   > **Important**
   >
   > Secrets cannot be moved from one region to another after creation.

3. Click **+ Create secret**.

4. Add your secret:

   * Choose whether to add your secret manually or import it.

     > **Note**
     >
     > The maximum file size for your secret is 64 KiB.

   * Choose a [secret type](/en/docs/secret-manager/concepts/#secret-types) and enter or upload your secret value.

5. Choose a Key Manager encryption key:

   * Scaleway-managed encryption key: requires no configuration on your side.

   * Manually-managed encryption key: an existing [Key Manager](/en/docs/key-manager) key you have previously created.

6. Choose a [path](/en/docs/secret-manager/concepts/#path) for your secret.

   > **Important**
   >
   > A [path](/en/docs/secret-manager/concepts/#path) is the directory structure to access your secrets and their [versions](/en/docs/secret-manager/concepts/#version). Each path **must be prefixed** with a slash.

7. Enter a name for your secret, and, optionally, add a description and tags.

8. Optionally, click to enable [secret protection](/en/docs/secret-manager/concepts/#secret-protection).

9. Optionally, click next to **Enable single access** or **Enable Time to Live** to apply an [ephemeral policy](/en/docs/secret-manager/concepts/#ephemeral-policy) to your secret and its versions.

   > **Important**
   >
   > * **Single access**: allows you to set your secret versions to **expire after one single access**.
   > * **Time to Live**: allows you to set a time frame of up to one year, during which your secret versions are valid and accessible.
   > * The ephemeral policy can only be applied to a secret at creation, and **cannot be removed** once applied.
   > * Once applied to a secret, the ephemeral policy's settings will be applied to all the secret's versions (even those created subsequently).

10. Check the estimated cost and click **Create secret** to confirm. The **Overview** tab of your secret displays with information such as the region of your secret, its encryption key, the secret's ID, etc.

    > **Note**
    >
    > * The value of your secret is stored in its first version, which is enabled by default. At creation, your secret only has one version. Find out [how to add more versions](/en/docs/secret-manager/how-to/create-version/) to your secret.
    > * Your path and secret are created on the go.

**Create more secrets**

1. Click **Secret Manager** in the **Security and Identity** section of the [Scaleway console](https://console.scaleway.com/) side menu.

2. Select your desired [region](/en/docs/secret-manager/concepts/#region) in the **Region** drop-down.

   > **Important**
   >
   > Secrets cannot be moved from one region to another after creation.

3. Click **+ Create secret**.

4. Add your secret:

   * Choose whether to add your secret manually or import it from a file.

     > **Note**
     >
     > The maximum file size for your secret is 64 KiB.

   * Choose a [secret type](/en/docs/secret-manager/concepts/#secret-types) and enter or upload your secret value.

5. Choose a Key Manager encryption key:

   * Scaleway-managed encryption key: requires no configuration on your side.

   * Manually-managed encryption key: an existing Key Manager key you have previously created.

6. Choose a [path](/en/docs/secret-manager/concepts/#path) for your secret:

   * Enter an existing [path](/en/docs/secret-manager/concepts/#path).

   * Create a new path. The path name **must be prefixed** with a slash.

7. Enter a name for your secret, and, optionally, add a description and tags.

8. Optionally, click to enable [secret protection](/en/docs/secret-manager/concepts/#secret-protection).

9. Optionally, click next to **Enable single access** or **Enable Time to Live** to apply an [ephemeral policy](/en/docs/secret-manager/concepts/#ephemeral-policy) to your secret and its versions.

   > **Important**
   >
   > * **Single access**: allows you to set your secret versions to **expire after one single access**.
   > * **Time to Live**: allows you to set a time frame of up to one year, during which your secret versions are valid and accessible.
   > * The ephemeral policy can only be applied to a secret at creation, and **cannot be removed** once applied.
   > * Once applied to a secret, the ephemeral policy's settings will be applied to all the secret's versions (even those created subsequently).

10. Click **Create secret**. The **Overview** tab of your secret displays with information such as the region of your secret, its encryption key, the secret's ID, etc.

    > **Note**
    >
    > * The value of your secret is stored in its first version, which is enabled by default. At creation, your secret only has one version. Find out [how to add more versions](/en/docs/secret-manager/how-to/create-version/) to your secret.
    > * If you have created a path that did not exist yet, your path and secret are created on the go.
