If your credentials leak due to internal or external incidents, you should rotate them. ## Rotating the Primary Credential To rotate your primary (main) credential: 1. Go to your license credentials page.

1. Press the "Rotate" button next to the main credential. 1. Read the disclaimers.

1. Press the "I understand. Send me an email with the rotation link." button. 1. Open the link received in the email. It opens a confirmation page. Your credentials are **not** rotated yet.

1. Press the "Rotate my credentials" button. Your old credentials stop working, and you cannot restore them. 1. View your new credentials and replace them in your Gemfile and any other place where you use them. ### Rotating the Primary Credential / Rotating Additional Credentials If you use [additional credentials](https://karafka.io/docs/Pro-Rotating-Credentials/Pro-Getting-Started.md#additional-credentials) (e.g. for CI or development environments), you can rotate each one independently from the license credentials page. Press the "Rotate" button next to the credential you want to rotate. Then press the "I understand. Send me an email with the rotation link." button and open the link received in the email. The link opens a confirmation page. Press the "Rotate this credential" button on it to rotate the credential. Other credentials do not change. ### Rotating the Primary Credential / See Also - [Pro Security](https://karafka.io/docs/Pro-Rotating-Credentials/Pro-Security.md) - Security best practices - [Deployment](https://karafka.io/docs/Pro-Rotating-Credentials/Infrastructure-Deployment.md) - Deployment strategies and best practices - [AWS MSK Guide](https://karafka.io/docs/Pro-Rotating-Credentials/Infrastructure-AWS-MSK-Guide.md) - AWS MSK integration guide --- *Last modified: 2026-11-10 13:00:12*