Meilisearch Safeops is a production-focused template that adds operational safety around Meilisearch. It helps teams avoid version-related crashes, run repeatable backup/restore workflows, and keep deployments stable with pinned image versions and health checks.
This template deploys Meilisearch with a companion SafeOps runner service on Railway. Meilisearch runs with a pinned image version (no latest drift), while SafeOps exposes operational endpoints for backup, snapshot, restore preparation, status checks, and file download operations. You can use local volume backups by default, and optionally enable S3 uploads for off-platform retention. The template is designed for teams that need reliability first: predictable upgrades, safer rollbacks, and less downtime during operational changes.
- Protecting Meilisearch data before upgrades or infrastructure changes.
- Running repeatable dump/snapshot workflows with optional S3 retention.
- Preventing deployment instability caused by image/version mismatches.
- Meilisearch (pinned image tag, e.g.
getmeili/meilisearch:v1.38.2) - SafeOps runner service (Node.js API for backup/restore orchestration)
- Meilisearch Docs: https://www.meilisearch.com/docs
- Meilisearch Update & Migration Guide: https://www.meilisearch.com/docs/learn/update_and_migration/updating
- Railway Docs: https://docs.railway.com
- AWS S3 (optional): https://docs.aws.amazon.com/s3/
SafeOps exposes:
GET /healthGET /(UI, Basic Auth protected)GET /ops/statusGET /ops/files?type=dump|snapshotGET /ops/files/:type/:name/downloadPOST /ops/backup/dumpPOST /ops/backup/snapshotPOST /ops/restore
Recommended environment defaults:
MEILI_HTTP_ADDR=0.0.0.0:7700PORT=3002MEILI_DB_PATH=/meili_data/data.msMEILI_IMAGE_TAG=v1.38.2SAFEOPS_ADMIN_USER=adminSAFEOPS_ADMIN_PASSWORD=${{ secret(24) }}
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 Meilisearch Safeops 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.