Last updated 24 days ago

Koyeb Secrets allow secure storage and usage of sensitive information like password or API tokens. The secrets feature can be used in stacks and need to be used to connect 3rd party stores.

You can use secrets to store:

  • databases or APIs access credentials,
  • third-party provider credentials,
  • reusable configuration variables.

All secret values are automatically encrypted server side to ensure secure storage. To prevent unauthorized access, Secrets access need to be explicitly granted in Stack functions.

Create a Secret

There are two steps to create a Secret.

  1. Click on Secrets in the left side menu to go the secrets page and click on New at the top right.
  2. In the Create Secret modal, enter your Secret name and value. Use an explicit name as you will need it to use the secret and validate to save your secret.

Your Secret is created and is now ready to be used!

Using secrets

Secrets can be used with stores and stacks:

Delete a Secret

Deleting a Secret is permanent and irreversible. When you delete a Secret, all resources using it will lose access to its value.

  1. Click on Secrets in the left side menu to go the secrets listing page.
  2. In the Secrets list, click on the three dots of the Secret you want to delete and click on delete.
  3. A warning modal appears and asks for confirmation before deleting.

Your Secret is now deleted.