# 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**](/overview/building-apps-in-health-universe/creating-a-workspace.md) 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="/files/EpetB7DZVLmwaEYENm7Y" alt=""><figcaption></figcaption></figure>

**3. Select Your GitHub Repository**

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

    <figure><img src="/files/XDbjq3NUTnrx6r3s92jv" 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="/files/pnH0WXMRFG2psKcC7LvH" 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="/files/9n8acmWXbm5JHMVtNoXG" 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="/files/aT0JrVEFf5WJVIv9gPhd" alt=""><figcaption></figcaption></figure>
* Secrets Management information can be found [here](/overview/building-apps-in-health-universe/deploying-your-app-to-health-universe/secret-management.md).

**6. Configure Visibility**

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

    <figure><img src="/files/RdIfRsLbuK64OHpH1Yxa" 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="/files/nkUIvCuIAeWWtqgPjK14" 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="/files/qGqpWdvxQuvaaWCBKPmh" 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](/overview/testing-your-app.md).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.healthuniverse.com/overview/building-apps-in-health-universe/deploying-your-app-to-health-universe/deploying-to-health-universe.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.