How to Create a New Porter Token

Why do users need to create Porter tokens?

Porter automatically generates tokens for users when they create an app. These tokens have authorization tied to the user who created the app and expires after a year. If an organization removes the user tied to the token used in a GitHub action (GHA) or a year passed, the token will become invalid, and users will have to manually update the token in Github.

How to generate a valid new token

Head to the Porter dashboard of your project. Select the Project Settings menu at the left of your dashboard and, then head to the API Tokens tab. Create a token with at least developer permissions and copy it. Then you can use the token for any needs.

If you need to update the token used by your GH actions, find the secret used by your GHA in the respective repo and change the value for the new token.