# Deploying to Health Universe

Deploying your app on Health Universe is a straightforward process that links your GitHub repository to a selected workspace. Follow the steps below to get your app live.

> 📌 **Note:** Make sure your GitHub account is linked to Health Universe before deploying. [Learn how »](https://docs.healthuniverse.com/overview/building-apps-in-health-universe/getting-started-with-health-universe/link-your-github-repository-to-your-health-universe-account)

#### ✅ Step-by-Step Deployment Instructions

**1. Go to Your Workspace**

* Log in to [Health Universe](https://www.healthuniverse.com/).
* Navigate to the [**workspace**](https://docs.healthuniverse.com/overview/building-apps-in-health-universe/creating-a-workspace) where you want to deploy your app (e.g., Personal, Organization, Enterprise, etc).
* Double-check that you're in the correct workspace, as deployments are workspace-specific.

**2. Open the Deployment Page**

* In your workspace, click the box labeled: **“Deploy a new app”** or head directly to <https://www.healthuniverse.com/create>.

  <figure><img src="https://1951440936-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS80fbh8wWG71Qtm77IKh%2Fuploads%2FA6QLOxV3dzDmZST0SILe%2FScreenshot%202025-05-28%20at%2010.06.10%E2%80%AFAM.png?alt=media&#x26;token=e3a348c9-73bf-4340-885b-0cca6d841bce" alt=""><figcaption></figcaption></figure>

**3. Select Your GitHub Repository**

* Under **Step 1: Select GitHub Repository**:
  * If your [GitHub account is properly connected](https://docs.healthuniverse.com/overview/building-apps-in-health-universe/getting-started-with-health-universe/link-your-github-account-to-your-health-universe-account), your repositories will appear in a dropdown. Choose the appropriate repository.

    <figure><img src="https://1951440936-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS80fbh8wWG71Qtm77IKh%2Fuploads%2FnWm7dpcduSZm4D100aX0%2FScreenshot%202025-05-28%20at%2010.07.45%E2%80%AFAM.png?alt=media&#x26;token=dacb5511-5ea2-4e37-9398-95d9f0e1a531" alt=""><figcaption></figcaption></figure>

**4. About Your App**

* Under **Step 2: About**, fill in:
  * **App Workspace:** From the dropdown, select the workspace you want to deploy your app to.
  * **App Name**: Give your app a clear, meaningful name.
  * **Description**: Write a short summary of what the app does.
  * **Research Area**: Choose the relevant field for your app’s purpose.

<figure><img src="https://1951440936-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS80fbh8wWG71Qtm77IKh%2Fuploads%2FgX6XBcDBrLZTDHEyfha3%2FScreenshot%202025-05-28%20at%2010.11.59%E2%80%AFAM.png?alt=media&#x26;token=39b65d6a-e864-47e8-ae54-efc6621a114a" alt=""><figcaption></figcaption></figure>

**5. Choose Runtime**

* Under **Step 3: Runtime**, select your app runtime:

  * **FastAPI**
    * [ ] Standalone
    * [ ] Add to Navigator *(if compatible)*
  * **Streamlit**
    * Always runs in Standalone mode

  > Only compatible FastAPI apps can be added to Navigator.
* Enter the name of your app’s main file (e.g., `main.py`) in the file name field.

  <figure><img src="https://1951440936-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS80fbh8wWG71Qtm77IKh%2Fuploads%2FeOavGOtmBVfjTOctEooz%2FScreenshot%202025-05-28%20at%2010.16.26%E2%80%AFAM.png?alt=media&#x26;token=d75cf08d-125b-4e54-9f47-2c4555b1923c" alt=""><figcaption></figcaption></figure>

**6. (Optional) Add Secrets**

* Under **Step 4: Secrets**, you'll find the **Environment Variables** section. This is where you can securely store sensitive information like API keys and tokens.

  * Enter a **Key** (e.g., `API_KEY`) and a **Value** (e.g., `sk-abcdefgh`).

  <figure><img src="https://1951440936-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS80fbh8wWG71Qtm77IKh%2Fuploads%2F432qUZTNQTsLn9kx5odj%2FScreenshot%202025-05-28%20at%2010.17.33%E2%80%AFAM.png?alt=media&#x26;token=3e8657d4-309c-4ef7-bb32-421d6060cd31" alt=""><figcaption></figcaption></figure>
* Secrets Management information can be found [here](https://docs.healthuniverse.com/overview/building-apps-in-health-universe/deploying-your-app-to-health-universe/secret-management).

**6. Configure Visibility**

* Under **Step 5: Privacy & Access**, choose whether your app should be:
  * **Private**: only you or workspace members can access it)&#x20;
  * **Public**:  anyone with the link can use it.

    <figure><img src="https://1951440936-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS80fbh8wWG71Qtm77IKh%2Fuploads%2FEQMBIee6vca0KS3dobVd%2FScreenshot%202025-05-28%20at%2010.19.48%E2%80%AFAM.png?alt=media&#x26;token=dd5601a5-8057-4452-8284-828e75d8e1a5" alt=""><figcaption></figcaption></figure>

**7. Submit the Deployment**

* Click the **Deploy App** button at the bottom of the form.

  <div align="left"><figure><img src="https://1951440936-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS80fbh8wWG71Qtm77IKh%2Fuploads%2Ft8pWo9pDIu3PWXXMLIsJ%2FScreenshot%202025-05-28%20at%2010.21.10%E2%80%AFAM.png?alt=media&#x26;token=94cc8825-eb7a-4def-9e42-d06dbdcb7e00" alt="" width="164"><figcaption></figcaption></figure></div>
* Your app will begin building. You’ll be shown real-time logs of the deployment process.

  <figure><img src="https://1951440936-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS80fbh8wWG71Qtm77IKh%2Fuploads%2F3dYWamdtkSK6uccAMZwW%2FScreenshot%202025-05-28%20at%2010.22.47%E2%80%AFAM.png?alt=media&#x26;token=97a54887-6ce1-437b-adfc-99a0247a1704" alt=""><figcaption></figcaption></figure>

**8. Watch the Logs**

* Monitor the build logs to ensure everything is running smoothly.
* Once deployment is complete, you'll be **automatically redirected** to your new app’s live page.
* Information on testing your app can be found [here](https://docs.healthuniverse.com/overview/testing-your-app).