# Server Deployment

Use this page to deploy the Bridge XR backend and web dashboard on your own infrastructure.

### What gets deployed

Your deployment includes:

* the **backend**
* the **web dashboard**
* the **web player** for browser-based experiences
* storage and database services used by the platform

{% hint style="info" %}
The Bridge XR App is separate from this deployment flow. It is distributed to **Meta Quest headsets** after the platform is live.
{% endhint %}

### Before you start

1. Fill out the [onboarding form](https://bridge-xr-form.lovable.app/).
2. Define the dashboard URL, such as `bridgexr.yourdomain.com`.
3. Share that URL with the Zoe Immersive team as early as possible.
4. Prepare your SSO setup with [SSO configuration](/bridge-xr/set-up-bridge-xr/server-deployment/sso-configuration.md).

{% hint style="warning" %}
Without the final dashboard URL, your Bridge XR client apps cannot point to the correct server.
{% endhint %}

### Infrastructure requirements

You need:

* S3-compatible object storage or Azure Blob Storage
* a PostgreSQL database
* a Bridge XR backend service
* a Bridge XR frontend service

#### Suggested starting sizes

* backend: around `10 GB` storage, `2 CPU`, `2 GB RAM`
* object storage: around `50 GB` to start
* database: around `20 GB` to start

Actual sizing depends on experience size, participant count, and usage frequency.

### Deployment steps

{% hint style="info" %}
For detailed information on the following steps please check the [Technical Guide](/bridge-xr/set-up-bridge-xr/server-deployment/technical-guide.md).
{% endhint %}

1. Download the Bridge XR **Web Files** from the Zoe for Unity [download page](https://zoeimmersive.com/unity/download/). Note: Make sure you are logged in with the correct account; otherwise you won't see those files.
2. Deploy the frontend files to a web server suitable for a single-page app.
3. Run the backend service on your Linux environment.
4. Seed the database with the provided script.
5. Connect SSO with [SSO Integration](/bridge-xr/set-up-bridge-xr/server-deployment/sso-integration.md).
6. Validate the platform in a testing environment if available.
7. Promote the deployment to production.

### After deployment

Once deployment is complete:

* add members in [Manage Organization and Members](/bridge-xr/use-bridge-xr/manage-organization-and-members.md)
* create modules in [Create and Manage Modules](/bridge-xr/use-bridge-xr/create-and-manage-modules.md)
* distribute the XR app to Meta Quest headsets.


---

# 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://unity.zoeimmersive.com/bridge-xr/set-up-bridge-xr/server-deployment.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.