# xprem. ## v3.2.0 (beta) - [Introduction](https://mercure-technologies.gitbook.io/xprem/3-2-0/introduction.md): Introduction to xprem. - [Quickstart](https://mercure-technologies.gitbook.io/xprem/3-2-0/quickstart.md) - [Overview](https://mercure-technologies.gitbook.io/xprem/3-2-0/installation-guide/overview.md) - [Server configuration](https://mercure-technologies.gitbook.io/xprem/3-2-0/installation-guide/server-configuration.md) - [Database configuration](https://mercure-technologies.gitbook.io/xprem/3-2-0/installation-guide/database-configuration.md) - [Storage configuration](https://mercure-technologies.gitbook.io/xprem/3-2-0/installation-guide/storage-configuration.md) - [CDN & Assets delivery](https://mercure-technologies.gitbook.io/xprem/3-2-0/installation-guide/cdn-and-assets-delivery.md) - [Cache configuration](https://mercure-technologies.gitbook.io/xprem/3-2-0/installation-guide/cache-configuration.md) - [Geolocation & Observe configuration](https://mercure-technologies.gitbook.io/xprem/3-2-0/installation-guide/geolocation-and-observe-configuration.md): Configure optional device geolocation and Expo Observe metrics. - [Deploy your server](https://mercure-technologies.gitbook.io/xprem/3-2-0/installation-guide/deploy-your-server.md) - [Configure your application](https://mercure-technologies.gitbook.io/xprem/3-2-0/installation-guide/configure-your-application.md) - [Railway](https://mercure-technologies.gitbook.io/xprem/3-2-0/deployment/railway.md): Deploy xprem using Railway, a platform for deploying and managing applications. - [Helm template](https://mercure-technologies.gitbook.io/xprem/3-2-0/deployment/helm-template.md) - [Docker image](https://mercure-technologies.gitbook.io/xprem/3-2-0/deployment/docker-image.md): Deploy xprem on your own infrastructure with Docker. - [Serve under a path prefix](https://mercure-technologies.gitbook.io/xprem/3-2-0/deployment/serve-under-a-path-prefix.md): Run the server at a path such as https://org.com/ota. - [Local development](https://mercure-technologies.gitbook.io/xprem/3-2-0/local-environment/local-development.md) - [Local testing](https://mercure-technologies.gitbook.io/xprem/3-2-0/local-environment/local-testing.md) - [Overview](https://mercure-technologies.gitbook.io/xprem/3-2-0/eoas/overview.md) - [Publish an update](https://mercure-technologies.gitbook.io/xprem/3-2-0/eoas/publish-an-update.md) - [Progressive rollouts](https://mercure-technologies.gitbook.io/xprem/3-2-0/eoas/progressive-rollouts.md) - [Rollback](https://mercure-technologies.gitbook.io/xprem/3-2-0/eoas/rollback.md) - [Republish](https://mercure-technologies.gitbook.io/xprem/3-2-0/eoas/republish.md) - [MCP Server](https://mercure-technologies.gitbook.io/xprem/3-2-0/ai/mcp-server.md): Drive your xprem server from any MCP client, authenticated with your dashboard account and bounded by its permissions. - [Overview](https://mercure-technologies.gitbook.io/xprem/3-2-0/identity/overview.md): How xprem builds its device registry from the traffic your app already sends, and what each touchpoint contributes. - [Geolocation](https://mercure-technologies.gitbook.io/xprem/3-2-0/identity/geolocation.md): The two strategies xprem can use to locate devices: visitor-location headers from a trusted proxy, or a MaxMind GeoLite2 database the server downloads itself. - [Overview](https://mercure-technologies.gitbook.io/xprem/3-2-0/observe/overview.md): What Observe adds to your server: performance metrics, logs and crash signals from the field, tied to the update each device runs. - [Get started with Observe](https://mercure-technologies.gitbook.io/xprem/3-2-0/observe/get-started-with-observe.md): Server and app setup for Observe: a ClickHouse database on one side, the expo-observe SDK on the other. - [Custom attributes](https://mercure-technologies.gitbook.io/xprem/3-2-0/observe/custom-attributes.md): Attach your own metadata to devices with the $set, $set\_once and $unset events, against a schema you declare in the dashboard. - [Configuration](https://mercure-technologies.gitbook.io/xprem/3-2-0/dashboard/configuration.md) - [Users](https://mercure-technologies.gitbook.io/xprem/3-2-0/dashboard/users.md) - [Overview](https://mercure-technologies.gitbook.io/xprem/3-2-0/storage/overview.md) - [Local Storage](https://mercure-technologies.gitbook.io/xprem/3-2-0/storage/local-storage.md) - [S3 Storage](https://mercure-technologies.gitbook.io/xprem/3-2-0/storage/s3-storage.md): Configure Amazon S3 or S3-compatible object storage for update assets. - [Google Cloud Storage](https://mercure-technologies.gitbook.io/xprem/3-2-0/storage/google-cloud-storage.md): Configure Google Cloud Storage for xprem assets. - [Azure Blob Storage](https://mercure-technologies.gitbook.io/xprem/3-2-0/storage/azure-blob-storage.md) - [Keys](https://mercure-technologies.gitbook.io/xprem/3-2-0/key-store/keys.md) - [Local Key Store](https://mercure-technologies.gitbook.io/xprem/3-2-0/key-store/local-key-store.md) - [AWS Secrets Manager](https://mercure-technologies.gitbook.io/xprem/3-2-0/key-store/aws-secrets-manager.md) - [Overview](https://mercure-technologies.gitbook.io/xprem/3-2-0/caching/overview.md) - [Redis](https://mercure-technologies.gitbook.io/xprem/3-2-0/caching/redis.md): Configure Redis as the shared cache for multi-replica deployments. - [Overview](https://mercure-technologies.gitbook.io/xprem/3-2-0/cdn/overview.md) - [CloudFront](https://mercure-technologies.gitbook.io/xprem/3-2-0/cdn/cloudfront.md): Configure Amazon CloudFront to deliver private update assets securely. - [Generic CDN](https://mercure-technologies.gitbook.io/xprem/3-2-0/cdn/generic-cdn.md) - [Audit log](https://mercure-technologies.gitbook.io/xprem/3-2-0/security/audit-log.md): Every state-changing action on the server, recorded for security reviews and investigations. - [Single sign-on (SSO)](https://mercure-technologies.gitbook.io/xprem/3-2-0/security/single-sign-on-sso.md) - [User roles & RBAC](https://mercure-technologies.gitbook.io/xprem/3-2-0/security/user-roles-and-rbac.md) - [Token access](https://mercure-technologies.gitbook.io/xprem/3-2-0/security/token-access.md): Scope what each API token may do: which branches, which actions, and from which networks. - [Prometheus & Grafana](https://mercure-technologies.gitbook.io/xprem/3-2-0/monitoring/prometheus-and-grafana.md) - [Branches and release channels](https://mercure-technologies.gitbook.io/xprem/3-2-0/concepts/branches-and-release-channels.md) - [Branch surfing](https://mercure-technologies.gitbook.io/xprem/3-2-0/features/branch-surfing.md): Let testers switch a build to another branch at runtime, without a new binary. - [Bundle Diffing (bsdiff)](https://mercure-technologies.gitbook.io/xprem/3-2-0/features/bundle-diffing-bsdiff.md) - [Environment variables](https://mercure-technologies.gitbook.io/xprem/3-2-0/references/environment-variables.md) - [Open core and licensing](https://mercure-technologies.gitbook.io/xprem/3-2-0/references/open-core-and-licensing.md) - [Benchmark](https://mercure-technologies.gitbook.io/xprem/3-2-0/references/benchmark.md) - [Getting Started](https://mercure-technologies.gitbook.io/xprem/3-2-0/stateless-mode/getting-started.md) - [Overview](https://mercure-technologies.gitbook.io/xprem/3-2-0/stateless-mode/overview.md) - [Migrate from v2 to v3](https://mercure-technologies.gitbook.io/xprem/3-2-0/changelog-and-migrations/migrate-from-v2-to-v3.md) - [Upgrade to v3.2](https://mercure-technologies.gitbook.io/xprem/3-2-0/changelog-and-migrations/upgrade-to-v3.2.md) ## v3.1.X (latest) - [Introduction](https://mercure-technologies.gitbook.io/xprem/introduction.md): Introduction to xprem. - [Quickstart](https://mercure-technologies.gitbook.io/xprem/quickstart.md) - [Overview](https://mercure-technologies.gitbook.io/xprem/installation-guide/overview.md) - [Server configuration](https://mercure-technologies.gitbook.io/xprem/installation-guide/server-configuration.md) - [Database configuration](https://mercure-technologies.gitbook.io/xprem/installation-guide/database-configuration.md) - [Storage configuration](https://mercure-technologies.gitbook.io/xprem/installation-guide/storage-configuration.md) - [CDN & Assets delivery](https://mercure-technologies.gitbook.io/xprem/installation-guide/cdn-and-assets-delivery.md) - [Cache configuration](https://mercure-technologies.gitbook.io/xprem/installation-guide/cache-configuration.md) - [Geolocation & Observe configuration](https://mercure-technologies.gitbook.io/xprem/installation-guide/geolocation-and-observe-configuration.md): Configure optional device geolocation and Expo Observe metrics. - [Deploy your server](https://mercure-technologies.gitbook.io/xprem/installation-guide/deploy-your-server.md) - [Configure your application](https://mercure-technologies.gitbook.io/xprem/installation-guide/configure-your-application.md) - [Railway](https://mercure-technologies.gitbook.io/xprem/deployment/railway.md): Deploy xprem using Railway, a platform for deploying and managing applications. - [Helm template](https://mercure-technologies.gitbook.io/xprem/deployment/helm-template.md) - [Docker image](https://mercure-technologies.gitbook.io/xprem/deployment/docker-image.md): Deploy xprem on your own infrastructure with Docker. - [Serve under a path prefix](https://mercure-technologies.gitbook.io/xprem/deployment/serve-under-a-path-prefix.md): Run the server at a path such as https://org.com/ota. - [Local development](https://mercure-technologies.gitbook.io/xprem/local-environment/local-development.md) - [Local testing](https://mercure-technologies.gitbook.io/xprem/local-environment/local-testing.md) - [Overview](https://mercure-technologies.gitbook.io/xprem/eoas/overview.md) - [Publish an update](https://mercure-technologies.gitbook.io/xprem/eoas/publish-an-update.md) - [Progressive rollouts](https://mercure-technologies.gitbook.io/xprem/eoas/progressive-rollouts.md) - [Rollback](https://mercure-technologies.gitbook.io/xprem/eoas/rollback.md) - [Republish](https://mercure-technologies.gitbook.io/xprem/eoas/republish.md) - [MCP Server](https://mercure-technologies.gitbook.io/xprem/ai/mcp-server.md): Drive your xprem server from any MCP client, authenticated with your dashboard account and bounded by its permissions. - [Overview](https://mercure-technologies.gitbook.io/xprem/identity/overview.md): How xprem builds its device registry from the traffic your app already sends, and what each touchpoint contributes. - [Geolocation](https://mercure-technologies.gitbook.io/xprem/identity/geolocation.md): The two strategies xprem can use to locate devices: visitor-location headers from a trusted proxy, or a MaxMind GeoLite2 database the server downloads itself. - [Overview](https://mercure-technologies.gitbook.io/xprem/observe/overview.md): What Observe adds to your server: performance metrics, logs and crash signals from the field, tied to the update each device runs. - [Get started with Observe](https://mercure-technologies.gitbook.io/xprem/observe/get-started-with-observe.md): Server and app setup for Observe: a ClickHouse database on one side, the expo-observe SDK on the other. - [Custom attributes](https://mercure-technologies.gitbook.io/xprem/observe/custom-attributes.md): Attach your own metadata to devices with the $set, $set\_once and $unset events, against a schema you declare in the dashboard. - [Configuration](https://mercure-technologies.gitbook.io/xprem/dashboard/configuration.md) - [Users](https://mercure-technologies.gitbook.io/xprem/dashboard/users.md) - [Overview](https://mercure-technologies.gitbook.io/xprem/storage/overview.md) - [Local Storage](https://mercure-technologies.gitbook.io/xprem/storage/local-storage.md) - [S3 Storage](https://mercure-technologies.gitbook.io/xprem/storage/s3-storage.md): Configure Amazon S3 or S3-compatible object storage for update assets. - [Google Cloud Storage](https://mercure-technologies.gitbook.io/xprem/storage/google-cloud-storage.md): Configure Google Cloud Storage for xprem assets. - [Azure Blob Storage](https://mercure-technologies.gitbook.io/xprem/storage/azure-blob-storage.md) - [Keys](https://mercure-technologies.gitbook.io/xprem/key-store/keys.md) - [Local Key Store](https://mercure-technologies.gitbook.io/xprem/key-store/local-key-store.md) - [AWS Secrets Manager](https://mercure-technologies.gitbook.io/xprem/key-store/aws-secrets-manager.md) - [Overview](https://mercure-technologies.gitbook.io/xprem/caching/overview.md) - [Redis](https://mercure-technologies.gitbook.io/xprem/caching/redis.md): Configure Redis as the shared cache for multi-replica deployments. - [Overview](https://mercure-technologies.gitbook.io/xprem/cdn/overview.md) - [CloudFront](https://mercure-technologies.gitbook.io/xprem/cdn/cloudfront.md): Configure Amazon CloudFront to deliver private update assets securely. - [Generic CDN](https://mercure-technologies.gitbook.io/xprem/cdn/generic-cdn.md) - [Audit log](https://mercure-technologies.gitbook.io/xprem/security/audit-log.md): Every state-changing action on the server, recorded for security reviews and investigations. - [Single sign-on (SSO)](https://mercure-technologies.gitbook.io/xprem/security/single-sign-on-sso.md) - [User roles & RBAC](https://mercure-technologies.gitbook.io/xprem/security/user-roles-and-rbac.md) - [Token access](https://mercure-technologies.gitbook.io/xprem/security/token-access.md): Scope what each API token may do: which branches, which actions, and from which networks. - [Prometheus & Grafana](https://mercure-technologies.gitbook.io/xprem/monitoring/prometheus-and-grafana.md) - [Branches and release channels](https://mercure-technologies.gitbook.io/xprem/concepts/branches-and-release-channels.md) - [Branch surfing](https://mercure-technologies.gitbook.io/xprem/concepts/branch-surfing.md): Let testers switch a build to another branch at runtime, without a new binary. - [Environment variables](https://mercure-technologies.gitbook.io/xprem/references/environment-variables.md) - [Open core and licensing](https://mercure-technologies.gitbook.io/xprem/references/open-core-and-licensing.md) - [Benchmark](https://mercure-technologies.gitbook.io/xprem/references/benchmark.md) - [Getting Started](https://mercure-technologies.gitbook.io/xprem/stateless-mode/getting-started.md) - [Overview](https://mercure-technologies.gitbook.io/xprem/stateless-mode/overview.md) - [Migrate from v2 to v3](https://mercure-technologies.gitbook.io/xprem/changelog-and-migrations/migrate-from-v2-to-v3.md) ## v3.0.x - [Welcome](https://mercure-technologies.gitbook.io/xprem/3-0-x/welcome.md): Everything you need to build, deploy, and manage your Expo Open Ota server. - [Getting Started](https://mercure-technologies.gitbook.io/xprem/3-0-x/getting-started.md) - [Branches and release channels](https://mercure-technologies.gitbook.io/xprem/3-0-x/getting-started/branches-and-release-channels.md) - [Overview](https://mercure-technologies.gitbook.io/xprem/3-0-x/controle-plane-mode/overview.md): Run Expo Open OTA independently with PostgreSQL, scoped credentials, and multi-app management. - [Getting Started](https://mercure-technologies.gitbook.io/xprem/3-0-x/controle-plane-mode/getting-started.md) - [Local development](https://mercure-technologies.gitbook.io/xprem/3-0-x/controle-plane-mode/local-development.md) - [Overview](https://mercure-technologies.gitbook.io/xprem/3-0-x/stateless-mode/overview.md) - [Getting Started](https://mercure-technologies.gitbook.io/xprem/3-0-x/stateless-mode/getting-started.md) - [Local development](https://mercure-technologies.gitbook.io/xprem/3-0-x/stateless-mode/local-development.md) - [Railway](https://mercure-technologies.gitbook.io/xprem/3-0-x/deployment/railway.md): Deploy Expo Open OTA using Railway, a platform for deploying and managing applications. - [Kubernetes](https://mercure-technologies.gitbook.io/xprem/3-0-x/deployment/kubernetes.md) - [Custom deployment](https://mercure-technologies.gitbook.io/xprem/3-0-x/deployment/custom-deployment.md): Deploy Expo Open OTA on your own infrastructure with Docker. - [Local testing](https://mercure-technologies.gitbook.io/xprem/3-0-x/deployment/local-testing.md) - [Overview](https://mercure-technologies.gitbook.io/xprem/3-0-x/eoas/overview.md) - [Publish an update](https://mercure-technologies.gitbook.io/xprem/3-0-x/eoas/publish-an-update.md) - [Progressive rollouts](https://mercure-technologies.gitbook.io/xprem/3-0-x/eoas/progressive-rollouts.md) - [Rollback](https://mercure-technologies.gitbook.io/xprem/3-0-x/eoas/rollback.md) - [Republish](https://mercure-technologies.gitbook.io/xprem/3-0-x/eoas/republish.md) - [Configuration](https://mercure-technologies.gitbook.io/xprem/3-0-x/dashboard/configuration.md) - [Users](https://mercure-technologies.gitbook.io/xprem/3-0-x/dashboard/users.md) - [Overview](https://mercure-technologies.gitbook.io/xprem/3-0-x/storage/overview.md) - [Local Storage](https://mercure-technologies.gitbook.io/xprem/3-0-x/storage/local-storage.md) - [S3 Storage](https://mercure-technologies.gitbook.io/xprem/3-0-x/storage/s3-storage.md): Configure Amazon S3 or S3-compatible object storage for update assets. - [Google Cloud Storage](https://mercure-technologies.gitbook.io/xprem/3-0-x/storage/google-cloud-storage.md): Configure Google Cloud Storage for Expo Open OTA assets. - [Azure Blob Storage](https://mercure-technologies.gitbook.io/xprem/3-0-x/storage/azure-blob-storage.md) - [Keys](https://mercure-technologies.gitbook.io/xprem/3-0-x/key-store/keys.md) - [Local Key Store](https://mercure-technologies.gitbook.io/xprem/3-0-x/key-store/local-key-store.md) - [Environment Key Storage](https://mercure-technologies.gitbook.io/xprem/3-0-x/key-store/environment-key-storage.md) - [AWS Secrets Manager](https://mercure-technologies.gitbook.io/xprem/3-0-x/key-store/aws-secrets-manager.md) - [Overview](https://mercure-technologies.gitbook.io/xprem/3-0-x/caching/overview.md) - [Redis](https://mercure-technologies.gitbook.io/xprem/3-0-x/caching/redis.md): Configure Redis as the shared cache for multi-replica deployments. - [Overview](https://mercure-technologies.gitbook.io/xprem/3-0-x/cdn/overview.md) - [CloudFront](https://mercure-technologies.gitbook.io/xprem/3-0-x/cdn/cloudfront.md): Configure Amazon CloudFront to deliver private update assets securely. - [Generic CDN](https://mercure-technologies.gitbook.io/xprem/3-0-x/cdn/generic-cdn.md) - [Branch protection](https://mercure-technologies.gitbook.io/xprem/3-0-x/security/branch-protection.md) - [IP whitelisting](https://mercure-technologies.gitbook.io/xprem/3-0-x/security/ip-whitelisting.md) - [Audit log](https://mercure-technologies.gitbook.io/xprem/3-0-x/security/audit-log.md): Every state-changing action on the server, recorded for security reviews and investigations. - [Single sign-on (SSO)](https://mercure-technologies.gitbook.io/xprem/3-0-x/security/single-sign-on-sso.md) - [User roles & RBAC](https://mercure-technologies.gitbook.io/xprem/3-0-x/security/user-roles-and-rbac.md) - [Prometheus & Grafana](https://mercure-technologies.gitbook.io/xprem/3-0-x/monitoring/prometheus-and-grafana.md) - [Environment variables](https://mercure-technologies.gitbook.io/xprem/3-0-x/references/environment-variables.md) - [Open core and licensing](https://mercure-technologies.gitbook.io/xprem/3-0-x/references/open-core-and-licensing.md) - [Migrate from v2 to v3](https://mercure-technologies.gitbook.io/xprem/3-0-x/changelog-and-migrations/migrate-from-v2-to-v3.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on a page URL with the `ask` query parameter: ``` GET https://mercure-technologies.gitbook.io/xprem/introduction.md?ask= ``` 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.