---
title: "Deploy filament"
description: "Pluggable data replication with checkpointing and integrity events"
category: "Analytics"
url: https://railway.com/deploy/filament
---

# Deploy filament

Pluggable data replication with checkpointing and integrity events

**[Deploy filament on Railway](https://railway.com/template/filament)**

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

- **Creator:** Galaxy
- **Category:** Analytics

## Template content

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

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

### control-plane https://cdn.brandfetch.io/idBVMq8h32/theme/light/symbol.svg?c=1dxbfHSJFAPEGdCLU4o5B

- **Image:** ghcr.io/galaxy-io/filament/control-plane
- **Health check:** /readyz

### server https://cdn.brandfetch.io/idBVMq8h32/theme/light/symbol.svg?c=1dxbfHSJFAPEGdCLU4o5B

- **Image:** ghcr.io/galaxy-io/filament/server:latest
- **Health check:** /readyz

### nats https://assets.streamlinehq.com/image/private/w_300,h_300,ar_1/f_auto/v1/icons/4/nats-icon-0ovmtntyy36e4kbyz20o3y.png/nats-icon-6vybuuc6scjetei6o8l5xg.png?_a=DATAiZAAZAA0

- **Image:** nats:alpine3.22
- **Start command:** `nats-server --jetstream --store_dir /data --server_name filament-nats`

## Documentation

# Deploy and Host Filament on Railway

Filament is an open-source data replication platform for moving data from sources to sinks using full, incremental, or change data capture workflows. It provides durable checkpoints, verified batch writes, scheduling, recovery, an API, and a web interface for managing pipelines and runs.

## About Hosting Filament

This template deploys Filament’s server and control plane alongside PostgreSQL and NATS JetStream. PostgreSQL stores pipelines, connections, checkpoints, schedules, and run state, while NATS carries lifecycle events between services. The server exposes the Filament API and web application.

Because Railway does not provide a Kubernetes Jobs API, pipeline runs execute inside the control-plane service. This makes the template convenient for evaluations and straightforward hosted deployments without requiring a Kubernetes cluster.

## Common Use Cases

- Replicate data between databases, SaaS applications, and analytical stores
- Schedule full, incremental, and change data capture pipelines
- Build reliable ingestion workflows with durable checkpoints
- Monitor pipeline runs and recover safely from interruptions
- Manage connectors and pipelines through a web interface or API

## Dependencies for Filament Hosting

- PostgreSQL for durable application and checkpoint state
- NATS JetStream for event transport
- A stable encryption key for protecting stored connector credentials
- Filament server and control-plane container images

Connector-specific credentials are only required when you configure a source or destination.

## Implementation Details

The template runs the server and control plane as separate services and configures the control plane with `DISPATCH_MODE=inproc`. Runs therefore share the control plane’s CPU and memory. Keep the control plane at one replica to avoid scheduling and coordination races.

For production workloads that require isolated workers and independent per-run resources, Filament also supports Kubernetes deployment through its Helm chart.

## Why Deploy Filament on Railway?

Railway provides a simple way to deploy Filament and its supporting infrastructure as one connected stack. It handles service networking, persistent databases, environment-variable wiring, and application deployments, allowing you to start building data pipelines without first operating a Kubernetes cluster.

## Similar templates

- [Typesense vs Meilisearch](https://railway.com/deploy/typesense-vs-meilisearch) — self-hosted Typesense vs Meilisearch
- [Betterlytics](https://railway.com/deploy/betterlytics) — Betterlytics is a cookieless analytics platform GDPR-compliant.
- [Finance Tracker](https://railway.com/deploy/finance-tracker-1) — Private multi-user household finance ledger with budgets and CSV import.

Open this page in a browser: https://railway.com/deploy/filament