Welcome to Streamlit Cloud! First things first, before you get started with Streamlit Cloud, you need to have a Streamlit app to deploy. If you haven't built one yet, read our Get started docs or start with an Example app. Either way, it only takes a few minutes to create your first app.
How Streamlit Cloud works
Streamlit Cloud is a workspace for your team to deploy, manage, and collaborate on your Streamlit apps. You connect your Streamlit Cloud account directly to your GitHub repository (public or private) and then Streamlit Cloud launches the apps directly from the code you've stored on GitHub. Most apps will launch in only a few minutes, and any time you update the code on GitHub, your app will automatically update for you. This creates a fast iteration cycle for your deployed apps, so that developers and viewers of apps can rapidly prototype, explore, and update apps.
Don't use GitHub? We are building support for GitLab, Azure DevOps, Bitbucket and other providers. Contact our Enterprise team for more details.
Under the hood Streamlit Cloud handles all of the containerization, authentication, scaling, security and everything else so that all you need to worry about is creating the app. Maintaining Streamlit apps is easy. Containers get the latest security patches, are actively monitored for container health. We are also building the capability to observe and monitor apps.
Getting your workspace set up with Streamlit Cloud only takes a few minutes.
- Sign up for Streamlit Cloud
- Log in to your account
- Connect your Streamlit Cloud account to GitHub
- Explore your Streamlit Cloud workspace
- Invite other developers on your team
Sign up for Streamlit Cloud
Streamlit Cloud offers packages to fit whatever team size and workspace needs you have. To view different packages go to the Streamlit Cloud homepage.
Once you've selected a package, login to share.streamlit.io and follow the steps below.
Log in to share.streamlit.io
You can login to Streamlit Cloud with:
- Email based sign-in link: These are single-use links that are valid for up to 15 minutes.
If you're a developer, we recommend starting with GitHub the first time you login. You can later setup your account to login using Google or an SSO provider.
If you're sharing your app, your app's users can use any of the above methods to login.
Streamlit Cloud offers support for all other single sign-on (SSO) providers, but you will need to be on an Enterprise plan to connect SSO.
Connect your GitHub account
Next you need to authorize Streamlit to connect to your GitHub account. This lets your Streamlit Cloud workspace launch apps directly from the app files you store in your repos, as well as let the system check for updates to those app files so that your apps can automatically update. You will see two different authorization screens to give this access. Click "authorize" on both. Questions about GitHub permissions? Read more here!
You must have admin permissions to your repo in order to deploy apps. If you don't have admin access, talk to your IT team or manager about helping you set up your Streamlit Cloud account or reach out to firstname.lastname@example.org.
Authorization screen 1
Authorization screen 2
If you're having trouble finding where to connect your accounts, see this guide.
Explore your Streamlit Cloud workspace
Congrats! You are now logged in and ready to go. If you are joining someone else's workspace you may already see apps populated in your workspace. If not, then you need to deploy an app! Check out our next section on how to deploy an app. And if you need an app to deploy check out our example apps that include apps for machine learning, data science, and business use cases.
You may also find that you already have multiple Streamlit Cloud workspaces. Streamlit Cloud automatically groups your apps according to the corresponding GitHub repository's owner. In the upper right corner you can see the workspaces you have access to. If your team has already launched apps, then you will see those apps in your workspace. Read more about workspaces here.
Invite other developers to your workspace
Inviting other developers is simple, just invite them to your GitHub repository so that you can code on apps together, and then have them log in to share.streamlit.io. If you are working as a team, you likely are already in the same repos, so skip step 1 and go straight to having them log into share.streamlit.io
Streamlit Cloud inherits developer permissions from GitHub, so when your teammates log in, they will automatically view the workspaces you share. From there you can all deploy, manage, and share apps together.
And remember, whenever anyone on the team updates the code on GitHub, the app will also automatically update for you!