What permissions do I need to deploy my app for the first time with Streamlit?

If your app has never been deployed with Streamlit, you will need admin access to the app's GitHub repository to deploy for the first time. Deploying an app for the first time requires Streamlit to register a GitHub webhook, which depends on us having admin access to the relevant repository. By registering a webhook, Streamlit opts in to notifications automatically sent by GitHub when your code changes; these notifications let Streamlit know to update your app, which gives you the experience of your deployed app automatically updating whenever you push a commit.

The good news is that once you've deployed an app for the first time, your app can be deployed by you and anyone else with push access to the repository (no admin access needed). You also won't have to worry about updating your app when your GitHub repository changes; your app will automatically update when you've made a change to the repository.

<aside> 💡 You can read more about GitHub repository permission levels here.

</aside>

What permissions do I need to deploy if my app has already been deployed with Streamlit?

Great! If your app has already been deployed with Streamlit by you or someone else in your organization, all you need to deploy the app is push access to the app's GitHub repository. You can follow the steps here to deploy.

I already have admin permissions for my repository. How can I deploy the app?

Perfect! Just follow the steps here to deploy your app.

I don't have admin permissions for my repository. How can I deploy the app?

• Become an admin for the repository.
• Ask your admin to deploy your Streamlit apps.

How does Streamlit use my GitHub account?

When you connect your GitHub account, you are sent to an authentication screen on GitHub’s website. When you click "Approve," we get a token we can use to act on your behalf with any repositories you have access to in GitHub.

We use your GitHub token to do two things: