---
title: "Deploy Appwrite"
description: "Open-source Firebase alternative: auth, databases, storage, realtime"
category: "Other"
url: https://railway.com/deploy/appwrite-2
---

# Deploy Appwrite

Open-source Firebase alternative: auth, databases, storage, realtime

**[Deploy Appwrite on Railway](https://railway.com/template/appwrite-2)**

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

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

## Template content

### Appwrite Console https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/appwrite.png

- **Source:** https://github.com/aalfath/appwrite-railway-template
- **Health check:** /health

### Appwrite Maintenance https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/appwrite.png

- **Source:** https://github.com/aalfath/appwrite-railway-template
- **Start command:** `railway-start maintenance`

### Geo https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/appwrite.png

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

### 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"`

### AutoGravity https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/appwrite.png

- **Source:** https://github.com/aalfath/appwrite-railway-template
- **Health check:** /readyz

### Appwrite Interval https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/appwrite.png

- **Source:** https://github.com/aalfath/appwrite-railway-template
- **Start command:** `railway-start interval`

### Appwrite API https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/appwrite.png

- **Source:** https://github.com/aalfath/appwrite-railway-template
- **Health check:** /v1/health/version

### ExifTool https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/appwrite.png

- **Source:** https://github.com/aalfath/appwrite-railway-template
- **Health check:** /readyz

### Appwrite Worker https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/appwrite.png

- **Source:** https://github.com/aalfath/appwrite-railway-template
- **Start command:** `railway-start worker`

### PostgreSQL https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/postgresql.png

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

### ClickHouse https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/clickhouse.png

- **Source:** https://github.com/aalfath/appwrite-railway-template
- **Health check:** /ping

### Appwrite https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/appwrite.png

- **Source:** https://github.com/aalfath/appwrite-railway-template
- **Health check:** /__router/health
- **Public domain:** Yes

### Appwrite Scheduler https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/appwrite.png

- **Source:** https://github.com/aalfath/appwrite-railway-template
- **Start command:** `railway-start scheduler`

### Appwrite Realtime https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/appwrite.png

- **Source:** https://github.com/aalfath/appwrite-railway-template
- **Start command:** `railway-start realtime`

## Buckets

- **Bucket**

## Documentation

# Deploy and Host Appwrite on Railway

Appwrite is an open-source backend platform, often used as a self-hosted Firebase alternative. It gives web and mobile apps user authentication, databases, file storage, messaging and realtime events through one REST, GraphQL and WebSocket API, plus a web console to manage projects, users, data and API keys.

## About Hosting Appwrite

Appwrite 2.7.3 is not one container. Upstream ships an API, a realtime server, background workers, a scheduler, maintenance tasks, a web console, PostgreSQL, ClickHouse, Redis, file storage and helper services behind a reverse proxy, and they must share secrets and storage and start in the right order. This template wires 14 services and a Railway Bucket over Railway's private network, with generated secrets, volumes for PostgreSQL and ClickHouse, and health checks. Nothing is asked at deploy. Open the public URL and sign up right away: the first account becomes the console owner and further console sign-ups are refused.

## Common Use Cases

* Backend for web and mobile apps: sign-in, OAuth, teams, databases and file uploads
* Self-hosted Firebase or Supabase alternative under your own Railway account
* Realtime apps such as chat, dashboards and live collaboration through the realtime API

## Dependencies for Appwrite Hosting

* PostgreSQL 18 (Appwrite's image with pgvector and PostGIS) and ClickHouse, each on a volume
* Redis and a Railway Bucket (S3-compatible file storage)

### Deployment Dependencies

* Appwrite 2.7.3 (`appwrite/appwrite`, pinned by digest): https://github.com/appwrite/appwrite
* Template repo, built by every service except Redis: https://github.com/aalfath/appwrite-railway-template
* Appwrite self-hosting docs: https://appwrite.io/docs/advanced/self-hosting

### Implementation Details

Services in this template:

* **Appwrite** (public): Caddy router. Sends `/v1/realtime` to Realtime, `/v1` to the API and everything else to the Console.
* **Appwrite API**: REST and GraphQL API; creates and migrates the database schema when it starts.
* **Appwrite Realtime**: WebSocket server for realtime subscriptions.
* **Appwrite Worker**: all background queues (database jobs, mail, messaging, webhooks, audits, usage, deletes, migrations).
* **Appwrite Scheduler**, **Appwrite Maintenance**, **Appwrite Interval**: scheduled jobs, daily cleanup and periodic tasks.
* **Appwrite Console**: the web console.
* **PostgreSQL**, **ClickHouse**, **Redis**, **Bucket**: data, usage statistics, cache and queues, uploaded files.
* **Geo**, **ExifTool**, **AutoGravity**: IP to country lookups, image metadata stripping, focal points for image previews.

After deploy: sign up at the public URL, create a project, add a Web platform for your app's hostname and point your SDK at `https://YOUR-DOMAIN/v1`. Email (verification, password recovery, invites) is off until you set `_APP_SMTP_HOST`, `_APP_SMTP_PORT`, `_APP_SMTP_USERNAME`, `_APP_SMTP_PASSWORD` and `_APP_SYSTEM_EMAIL_ADDRESS` on Appwrite API and Appwrite Worker. If you add a custom domain, update `_APP_DOMAIN` and `_APP_CONSOLE_URL` on the six Appwrite services. Never change `_APP_OPENSSL_KEY_V1` after the first deploy.

Not included: Functions and Sites builds and executions, because Appwrite's executor needs the host's Docker socket, which Railway does not offer. MQTT messaging and the optional AI and screenshot services are left out too.

Updates: every image is pinned by version and digest in the template repo. A new Appwrite version arrives as a commit there, and Railway shows an "update available" notice on your project, so you choose when to apply it. Read the repo's CHANGELOG first.

## Why Deploy Appwrite 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 Appwrite 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/appwrite-2
