---
title: "Deploy Open Wearables"
description: "Wearable health data API: backend, portal, Celery, Svix, Postgres, Redis"
category: "Other"
url: https://railway.com/deploy/open-wearables-2
---

# Deploy Open Wearables

Wearable health data API: backend, portal, Celery, Svix, Postgres, Redis

**[Deploy Open Wearables on Railway](https://railway.com/template/open-wearables-2)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/open-wearables-2/manifest.json

- **Creator:** Agaz Self-Host
- **Category:** Other

## Template content

### celery-beat https://cdn.jsdelivr.net/gh/the-momentum/open-wearables@0.11.0/frontend/static/android-chrome-512x512.png

- **Source:** https://github.com/aalfath/open-wearables-railway-template

### svix-server https://cdn.jsdelivr.net/gh/the-momentum/open-wearables@0.11.0/frontend/static/android-chrome-512x512.png

- **Source:** https://github.com/aalfath/open-wearables-railway-template
- **Health check:** /api/v1/health/

### Postgres https://devicons.railway.app/i/postgresql.svg

- **Image:** ghcr.io/railwayapp-templates/postgres-ssl:18

### backend https://cdn.jsdelivr.net/gh/the-momentum/open-wearables@0.11.0/frontend/static/android-chrome-512x512.png

- **Source:** https://github.com/aalfath/open-wearables-railway-template
- **Health check:** /
- **Public domain:** Yes

### Redis https://cdn.sanity.io/images/sy1jschh/production/0ce0bfdcfbdbf69662b1116671f97c2dd788b655-157x157.svg

- **Image:** redis:8.2
- **Start command:** `/bin/sh -c "rm -rf $RAILWAY_VOLUME_MOUNT_PATH/lost+found/ && exec docker-entrypoint.sh redis-server --requirepass $REDIS_PASSWORD --save 60 1 --dir $RAILWAY_VOLUME_MOUNT_PATH"`

### frontend https://cdn.jsdelivr.net/gh/the-momentum/open-wearables@0.11.0/frontend/static/android-chrome-512x512.png

- **Source:** https://github.com/aalfath/open-wearables-railway-template
- **Health check:** /login
- **Public domain:** Yes

### celery-worker https://cdn.jsdelivr.net/gh/the-momentum/open-wearables@0.11.0/frontend/static/android-chrome-512x512.png

- **Source:** https://github.com/aalfath/open-wearables-railway-template

## Documentation

# Deploy and Host Open Wearables on Railway

Open Wearables is an open-source (MIT) platform that pulls health data from wearables such as Garmin, Oura, Whoop, Polar, Suunto, Withings and Apple Health into one database and serves it through one REST API. It includes a developer portal where you manage users, provider connections, API keys and outgoing webhooks.

## About Hosting Open Wearables

Open Wearables needs more than one container. A FastAPI backend serves the API and runs the database migrations, a Celery worker does the provider syncs and data processing, Celery beat schedules the recurring syncs, and a SvelteKit portal is the web UI. PostgreSQL stores users and health data, Redis is the Celery broker and cache, and Svix delivers signed outgoing webhooks. This template wires all of them over Railway's private network, generates every secret, keeps PostgreSQL and Redis on volumes, and pins Open Wearables 0.11.0 by image digest. The only thing it asks you for is the admin email. To pull data from real devices you add each provider's OAuth app credentials after the deploy.

## Common Use Cases

* Give a health, fitness or coaching app one API for data from many wearable brands
* Keep wearable and health data on infrastructure you control, instead of a paid aggregator
* Get webhooks when new sleep, activity or workout data arrives for your users

## Dependencies for Open Wearables Hosting

* PostgreSQL (Railway's PostgreSQL, on a volume)
* Redis (Railway's Redis, on a volume)

### Deployment Dependencies

* [Open Wearables 0.11.0 release](https://github.com/the-momentum/open-wearables/releases/tag/0.11.0)
* [Open Wearables Docker deployment docs](https://docs.openwearables.io/deployment/docker)
* [Provider setup guides](https://docs.openwearables.io/providers/supported)
* [Svix server](https://github.com/svix/svix-webhooks), v1.101.0 (the version upstream's Compose file runs)
* [Template repository](https://github.com/aalfath/open-wearables-railway-template)

### Implementation Details

The template deploys these services:

| Service | What it does | Public |
|---|---|---|
| `frontend` | Developer portal (SvelteKit). Open this URL and sign in | yes |
| `backend` | FastAPI API. Runs migrations and seed scripts on every start, then serves the API. Your apps, SDKs and provider webhooks call this URL | yes |
| `celery-worker` | Background jobs: provider syncs, Apple Health imports, webhook sends | no |
| `celery-beat` | Schedules the recurring syncs | no |
| `svix-server` | Delivers outgoing webhooks. Keeps its data in a `svix` database the backend creates in the same PostgreSQL | no |
| `Postgres` | Railway PostgreSQL, on a volume | no |
| `Redis` | Railway Redis, on a volume | no |

**After the deploy**

1. Open the `frontend` URL and sign in with the `ADMIN_EMAIL` you entered. The password is the generated `ADMIN_PASSWORD` in the `backend` service's Variables tab. Change it in the portal after your first sign-in. Changing `ADMIN_PASSWORD` later doesn't change an existing account.
2. Add more developers by invitation in the portal. Invitation emails need `RESEND_API_KEY`, or `SMTP_HOST`, `SMTP_PORT`, `SMTP_USERNAME`, `SMTP_PASSWORD` and `EMAIL_FROM_ADDRESS`, on `backend` and `celery-worker`.
3. For each provider you want, create an OAuth app on the provider's developer site (redirect URIs use the `backend` URL, which is already set as `API_BASE_URL`). Then add its variables, for example `GARMIN_CLIENT_ID` and `GARMIN_CLIENT_SECRET`, to **both** `backend` and `celery-worker`, because the worker refreshes tokens and runs the syncs. The [provider guides](https://docs.openwearables.io/providers/supported) list every variable.
4. Apple Health XML uploads and raw payload storage need an S3-compatible bucket (`AWS_BUCKET_NAME`, `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_ENDPOINT_URL`). They're optional.

**Good to know**

* Outgoing webhooks are on (`OUTGOING_WEBHOOKS_ENABLED=true`) and run through the bundled `svix-server`. They need no setup.
* Open Wearables sends anonymous usage counts to its developers by default (no user or health data). To turn that off, set `TELEMETRY_ENABLED=false` on `backend`, `celery-worker` and `celery-beat`.
* Flower, the Celery monitoring UI, isn't included, because it has no login of its own.

**Updates.** Every service builds from this repository, whose Dockerfiles pin the official `themomentum/open-wearables-backend`, `themomentum/open-wearables-frontend` and `svix/svix-server` images by version and digest. When a new release is pinned here, Railway shows an update notice on your project, and you choose when to apply it. Read [CHANGELOG.md](https://github.com/aalfath/open-wearables-railway-template/blob/main/CHANGELOG.md) first. The backend applies database migrations on its next start.

## Why Deploy Open Wearables on Railway?


Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Open Wearables on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.



## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — Self-hosted virtual tabletop for role-playing games (license required)
- [Double Commander in your browser](https://railway.com/deploy/double-commander-in-your-browser) — The Double Commander file manager in the cloud, from any device

Open this page in a browser: https://railway.com/deploy/open-wearables-2
