Get started

Welcome to Streamlit Community Cloud! First things first, before you get started with Streamlit Community 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 Community Cloud works

Streamlit Community Cloud is a workspace for your team to deploy, manage, and collaborate on your Streamlit apps. You connect your Streamlit Community Cloud account directly to your GitHub repository (public or private) and then Streamlit Community 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.

Under the hood Streamlit Community 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 started

Getting your workspace set up with Streamlit Community Cloud only takes a few minutes.

1. Sign up for Streamlit Community Cloud
2. Log in to your account
3. Connect your Streamlit Community Cloud account to GitHub
4. Explore your Streamlit Community Cloud workspace
5. Invite other developers on your team

Sign up for Streamlit Community Cloud

Streamlit's Community Cloud allows you to deploy, manage, and share your apps with the world, directly from Streamlit — all for free. Sign up on the Community Cloud homepage.

Once you've signed up, login to share.streamlit.io and follow the steps below.

Log in to share.streamlit.io

You can login to Streamlit Community Cloud with:

1. Google
2. GitHub
3. 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.

If you're sharing your app, your app's users can use any of the above methods to login.

Sign in with Google

Visit share.streamlit.io and click the "Continue with Google" button.

Step 1: Click the 'Continue with Google' button

On the next page, choose an account to sign in with and enter your Google account credentials.

Step 2: Enter your Google account credentials

Once you have signed in to Google, you will be taken to your Streamlit Community Cloud workspace!🎈

Your Streamlit Community Cloud workspace

Sign in with GitHub

Visit share.streamlit.io and click the "Continue with GitHub" button.

Step 1: Click the 'Continue with GitHub' button

On the next page, enter your GitHub credentials to sign in.

Step 2: Enter your GitHub account credentials

Once you have signed in to GitHub, you will be taken to your Streamlit Community Cloud workspace!🎈

Your Streamlit Community Cloud workspace

Sign in with Email

If you don't have SSO, you can sign in with your email address! Visit share.streamlit.io, enter the email address you used to sign up for Streamlit Community Cloud, and click the "Continue with email" button.

Step 1: Enter your email address and click 'Continue with email'

Once you do so, you will see a confirmation message (like the one below) asking you to check your email.

Step 2: Check your inbox for an email from Streamlit

Check your inbox for an email from Streamlit, with the subject "Sign in to Streamlit Community Cloud". Click the link in the email to sign in to Streamlit. Note that this link will expire in 15 minutes and can only be used once.

Step 3: Click the link in the email to sign in to Streamlit

Once you click the link in your email, you will be taken to your Streamlit Community Cloud workspace!🎈

Your Streamlit Community Cloud workspace

Connect your GitHub account

Next you need to authorize Streamlit to connect to your GitHub account. This lets your Streamlit Community 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!

Authorization screen 1

Authorization screen 2

Explore your Streamlit Community 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 Community Cloud workspaces. Streamlit Community 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 Community 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!