Deploy on itch.io everytime you push on main branch in GitHub

CI/CD with Butler

28 janvier 2026

  1. On itch.io, in "Settings", under "Developer", click on "API keys". Then "Generate new API key".
  2. On github, in the repo page, click on "Settings" on the menu bar on the top of the window. On the left click on "Secrets and variables" then "Actions". Under "Secrets" > "Environment secrets", "Manage environment secrets" and add a new environment called ITCHIO. Now, you are under "Environments / Configure ITCHIO", click "Add environment secret", give it the name ITCHIO_SECRET and the value of the API key in itch.io. Add two other one called ITCHIO_USER, e.g., playdonttell and ITCHIO_GAME, e.g., my-game. PS: secrets are encrypted, variables are not.
  3. Install butler on your machine following the instructions here https://itch.io/docs/butler/installing.html.
  4. Get the butler api key, and add another environnment secret called BUTLER_API_KEY and give it the credential you obtained.
  5. Once you have those four environment secrets, you can do a PR and this is done!

Documentation used: