Penv Cloud
Start free
Docs
Reference

Koyeb secrets

Sync an environment with the simple secrets under one name prefix in your Koyeb organization.

Sync an environment with the simple secrets under one name prefix in your Koyeb organization.

Connection

WhatThis provider
VendorKoyeb
Keykoyeb-secrets
Availabilityavailable. You can connect it today.
Credential we holdkoyeb-token
Values read backyes
Activationon-next-deploy

Directions

DirectionWhat it does
importWe read names and values out of the store into your environment.
exportWe write names and values from your environment into the store.

Activation

on-next-deploy. A new value waits there and arrives with your next deploy.

Conflict policies

DirectionPolicies you can pick
importskip_existing, new_version, fail
exportcreate_only, overwrite, overwrite_and_prune

How syncs work says what each one does.

Connect

Paste a credential from the vendor. We seal it and never show it again.

FieldLabelKindRequiredWhat it is
apiKeyAPI keysecret; we mask it here and seal ityesAn organization API key from Organization settings, API. Koyeb keys carry no scopes: the key acts as the whole organization.

Mapping fields

You answer these once per environment you map.

FieldLabelKindRequiredAdvancedWhat it is
prefixName prefixtextyesnoA sync owns one prefix: it reads and writes only secrets whose names start with it, and adds it to every name it writes. Pruning permanently deletes every simple secret under the prefix that this environment lacks, including ones this sync did not write, and Koyeb cannot recover a deleted secret.