---
title: "Deploy Dify (w/ admin setup)"
description: "Dify AI app builder, admin created from the deploy form, one public URL."
category: "AI/ML"
url: https://railway.com/deploy/dify-w-admin-setup
---

# Deploy Dify (w/ admin setup)

Dify AI app builder, admin created from the deploy form, one public URL.

**[Deploy Dify (w/ admin setup) on Railway](https://railway.com/template/dify-w-admin-setup)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/dify-w-admin-setup/manifest.json

- **Creator:** AvgSoft
- **Category:** AI/ML

## Template content

### Setup https://cdn.jsdelivr.net/gh/mikedepo/railway-template-assets@ff030029127cc39bd7212cc10fe36eefde0019ea/service-icons/setup.svg

- **Image:** ghcr.io/railwayapp/function-bun:1.3.0
- **Start command:** `./run.sh Ly8gT25lLXRpbWUgc2V0dXAgZm9yIHRoZSAiRGlmeSIgdGVtcGxhdGUsIHJ1biBhcyBhIFJhaWx3YXkgRnVuY3Rpb24gKGdoY3IuaW8vcmFpbHdheWFwcC9mdW5jdGlvbi1idW4pLgovLyBDcmVhdGVzIERpZnkncyBmaXJzdCBhZG1pbiBmcm9tIHRoZSBkZXBsb3kgZm9ybSwgc28gbm9ib2R5IGVsc2UgY2FuIGNsYWltIHRoZSAvaW5zdGFsbCBwYWdlIGZpcnN0LgovLyBTYWZlIHRvIHJ1biBhZ2FpbjogaWYgRGlmeSBhbHJlYWR5IGhhcyBhbiBhZG1pbiwgaXQgZG9lcyBub3RoaW5nLgovLyBCdWlsZCB0aGUgdGVtcGxhdGUncyBzdGFydCBjb21tYW5kIGZyb20gdGhpcyBmaWxlOiAiLi9ydW4uc2ggIiArIGJhc2U2NChmaWxlKS4KLy8KLy8gVmFyaWFibGVzOiBESUZZX0FQSV9VUkwgKHByaXZhdGUgQVBJIFVSTCksIERJRllfVVJMIChwdWJsaWMgVVJMLCBmb3IgdGhlIGxvZyksIElOSVRfUEFTU1dPUkQgKHRoZSBBUEkncyksCi8vIEFETUlOX0VNQUlMLCBBRE1JTl9QQVNTV09SRCwgQURNSU5fTkFNRS4KCmNvbnN0IEFQSSA9IChwcm9jZXNzLmVudi5ESUZZX0FQSV9VUkwgPz8gJycpLnJlcGxhY2UoL1wvJC8sICcnKTsKY29uc3QgVVJMXyA9IChwcm9jZXNzLmVudi5ESUZZX1VSTCA/PyAnJykucmVwbGFjZSgvXC8kLywgJycpOwpjb25zdCBJTklUID0gcHJvY2Vzcy5lbnYuSU5JVF9QQVNTV09SRCA/PyAnJzsKY29uc3QgRU1BSUwgPSAocHJvY2Vzcy5lbnYuQURNSU5fRU1BSUwgPz8gJycpLnRyaW0oKTsKY29uc3QgUEFTU1dPUkQgPSBwcm9jZXNzLmVudi5BRE1JTl9QQVNTV09SRCA/PyAnJzsKY29uc3QgTkFNRSA9IChwcm9jZXNzLmVudi5BRE1JTl9OQU1FID8/ICcnKS50cmltKCkgfHwgJ0FkbWluJzsKCmNvbnN0IGxvZyA9IChtc2c6IHN0cmluZykgPT4gY29uc29sZS5sb2coYFtzZXR1cF0gJHttc2d9YCk7CmNvbnN0IHNsZWVwID0gKG1zOiBudW1iZXIpID0+IG5ldyBQcm9taXNlKChyKSA9PiBzZXRUaW1lb3V0KHIsIG1zKSk7CmNvbnN0IEZJWCA9ICdDaGFuZ2UgaXQgaW4gdGhlIFNldHVwIHNlcnZpY2VcJ3MgVmFyaWFibGVzIGFuZCByZWRlcGxveSBTZXR1cC4nOwovLyBFeGl0IDAgb24gZmFpbHVyZSB0b28sIHNvIGEgc2V0dXAgcHJvYmxlbSBuZXZlciBtYXJrcyB0aGUgZGVwbG95IGFzIGZhaWxlZDsgdGhlIGxvZyBzYXlzIGhvdyB0byBmaW5pc2guCmNvbnN0IHN0b3AgPSAobXNnOiBzdHJpbmcpOiBuZXZlciA9PiB7IGxvZyhtc2cpOyBwcm9jZXNzLmV4aXQoMCk7IH07CgppZiAoIUFQSSB8fCAhRU1BSUwgfHwgIVBBU1NXT1JEKSBzdG9wKCdtaXNzaW5nIERJRllfQVBJX1VSTCwgQURNSU5fRU1BSUwgb3IgQURNSU5fUEFTU1dPUkQnKTsKaWYgKCEvXlteQFxzXStAW15AXHNdK1wuW15AXHNdKyQvLnRlc3QoRU1BSUwpKSBzdG9wKGBBRE1JTl9FTUFJTCAiJHtFTUFJTH0iIGlzIG5vdCBhbiBlbWFpbCBhZGRyZXNzLiAke0ZJWH1gKTsKLy8gRGlmeSdzIHBhc3N3b3JkIHJ1bGUgKGFwaS9saWJzL3Bhc3N3b3JkLnB5KTogOCsgY2hhcmFjdGVycyB3aXRoIGF0IGxlYXN0IG9uZSBsZXR0ZXIgYW5kIG9uZSBudW1iZXIuCmlmICghL14oPz0uKlthLXpBLVpdKSg/PS4qXGQpLns4LH0kLy50ZXN0KFBBU1NXT1JEKSkgewogIHN0b3AoYEFETUlOX1BBU1NXT1JEIGlzIHRvbyB3ZWFrIGZvciBEaWZ5OiBpdCBuZWVkcyBhdCBsZWFzdCA4IGNoYXJhY3RlcnMsIHdpdGggYSBsZXR0ZXIgYW5kIGEgbnVtYmVyLiAke0ZJWH1gKTsKfQoKLy8gVGhlIEFQSSBydW5zIGl0cyBkYXRhYmFzZSBtaWdyYXRpb25zIGJlZm9yZSBpdCBhbnN3ZXJzLCB3aGljaCB0YWtlcyBhIG1pbnV0ZSBvciB0d28gb24gdGhlIGZpcnN0IGRlcGxveS4KbGV0IHVwID0gZmFsc2U7CmZvciAobGV0IGkgPSAwOyBpIDwgOTAgJiYgIXVwOyBpKyspIHsKICB0cnkgeyB1cCA9IChhd2FpdCBmZXRjaChgJHtBUEl9L2hlYWx0aGApKS5vazsgfSBjYXRjaCB7fQogIGlmICghdXApIGF3YWl0IHNsZWVwKDEwXzAwMCk7Cn0KaWYgKCF1cCkgc3RvcChgdGhlIERpZnkgQVBJIGRpZCBub3QgY29tZSB1cCB3aXRoaW4gMTUgbWludXRlcyAoJHtBUEl9L2hlYWx0aClgKTsKbG9nKCdEaWZ5IEFQSSBpcyB1cCcpOwoKY29uc3Qgc3RhdGU6IGFueSA9IGF3YWl0IChhd2FpdCBmZXRjaChgJHtBUEl9L2NvbnNvbGUvYXBpL3NldHVwYCkpLmpzb24oKTsKaWYgKHN0YXRlLnN0ZXAgPT09ICdmaW5pc2hlZCcpIHN0b3AoJ0RpZnkgYWxyZWFkeSBoYXMgYW4gYWRtaW47IG5vdGhpbmcgdG8gZG8nKTsKCi8vIElOSVRfUEFTU1dPUkQgbG9ja3MgRGlmeSdzIC9pbnN0YWxsIHBhZ2UgdW50aWwgaXQgaXMgZW50ZXJlZDsgU2V0dXAgZW50ZXJzIGl0LCB0aGVuIGNyZWF0ZXMgdGhlIGFkbWluLgpsZXQgY29va2llID0gJyc7CmlmIChJTklUKSB7CiAgY29uc3QgcmVzID0gYXdhaXQgZmV0Y2goYCR7QVBJfS9jb25zb2xlL2FwaS9pbml0YCwgeyBtZXRob2Q6ICdQT1NUJywgaGVhZGVyczogeyAnY29udGVudC10eXBlJzogJ2FwcGxpY2F0aW9uL2pzb24nIH0sIGJvZHk6IEpTT04uc3RyaW5naWZ5KHsgcGFzc3dvcmQ6IElOSVQgfSkgfSk7CiAgaWYgKCFyZXMub2spIHN0b3AoYERpZnkgcmVmdXNlZCBJTklUX1BBU1NXT1JEIChIVFRQICR7cmVzLnN0YXR1c30pOyBpdCBtdXN0IG1hdGNoIHRoZSBBUEkgc2VydmljZSdzIElOSVRfUEFTU1dPUkRgKTsKICBjb29raWUgPSAocmVzLmhlYWRlcnMuZ2V0U2V0Q29va2llPy4oKSA/PyBbXSkubWFwKChjKSA9PiBjLnNwbGl0KCc7JylbMF0pLmpvaW4oJzsgJyk7Cn0KY29uc3QgcmVzID0gYXdhaXQgZmV0Y2goYCR7QVBJfS9jb25zb2xlL2FwaS9zZXR1cGAsIHsKICBtZXRob2Q6ICdQT1NUJywKICBoZWFkZXJzOiB7ICdjb250ZW50LXR5cGUnOiAnYXBwbGljYXRpb24vanNvbicsIGNvb2tpZSB9LAogIGJvZHk6IEpTT04uc3RyaW5naWZ5KHsgZW1haWw6IEVNQUlMLCBuYW1lOiBOQU1FLCBwYXNzd29yZDogUEFTU1dPUkQsIGxhbmd1YWdlOiAnZW4tVVMnIH0pLAp9KTsKaWYgKCFyZXMub2spIHN0b3AoYGNyZWF0aW5nIHRoZSBEaWZ5IGFkbWluIGZhaWxlZCAoSFRUUCAke3Jlcy5zdGF0dXN9OiAkeyhhd2FpdCByZXMudGV4dCgpKS5zbGljZSgwLCAyMDApfSlgKTsKbG9nKGBjcmVhdGVkIHRoZSBEaWZ5IGFkbWluICR7RU1BSUx9YCk7CmxvZyhgRGlmeSBpcyByZWFkeTogb3BlbiAke1VSTF8gfHwgJ3RoZSBEaWZ5IHNlcnZpY2UgVVJMJ30gYW5kIHNpZ24gaW4gd2l0aCBBRE1JTl9FTUFJTCBhbmQgQURNSU5fUEFTU1dPUkQuYCk7Cg==`

### Dify https://cdn.jsdelivr.net/gh/mikedepo/railway-template-assets@ff030029127cc39bd7212cc10fe36eefde0019ea/service-icons/dify.svg

- **Image:** nginx:1.31-alpine
- **Start command:** `/bin/sh -c "mkdir -p /etc/nginx/templates && printenv NGINX_CONF > /etc/nginx/templates/default.conf.template && exec /docker-entrypoint.sh nginx -g 'daemon off;'"`
- **Health check:** /healthz
- **Public domain:** Yes

### Web https://cdn.jsdelivr.net/gh/mikedepo/railway-template-assets@ff030029127cc39bd7212cc10fe36eefde0019ea/service-icons/dify.svg

- **Image:** langgenius/dify-web:1.18.0
- **Health check:** /signin

### Worker https://cdn.jsdelivr.net/gh/mikedepo/railway-template-assets@ff030029127cc39bd7212cc10fe36eefde0019ea/service-icons/dify.svg

- **Image:** langgenius/dify-api:1.18.0
- **Start command:** `/bin/bash -c "case x$SMTP_SERVER in x) ;; *) export MAIL_TYPE=smtp ;; esac; exec /bin/bash /entrypoint.sh"`

### Redis https://cdn.jsdelivr.net/gh/mikedepo/railway-template-assets@ff030029127cc39bd7212cc10fe36eefde0019ea/service-icons/redis.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"`

### Postgres https://cdn.jsdelivr.net/gh/mikedepo/railway-template-assets@ff030029127cc39bd7212cc10fe36eefde0019ea/service-icons/postgresql.svg

- **Image:** pgvector/pgvector:pg17

### Sandbox https://cdn.jsdelivr.net/gh/mikedepo/railway-template-assets@ff030029127cc39bd7212cc10fe36eefde0019ea/service-icons/dify.svg

- **Image:** langgenius/dify-sandbox:0.2.15
- **Start command:** `/bin/bash -c "if test -f $NODE_TAR_XZ; then tar -xf $NODE_TAR_XZ -C /opt; rm -f $NODE_TAR_XZ; fi; mkdir -p /usr/local/bin; ln -sf $NODE_DIR/bin/node /usr/local/bin/node; exec /main"`
- **Health check:** /health

### API https://cdn.jsdelivr.net/gh/mikedepo/railway-template-assets@ff030029127cc39bd7212cc10fe36eefde0019ea/service-icons/dify.svg

- **Image:** langgenius/dify-api:1.18.0
- **Start command:** `/bin/bash -c "case x$SMTP_SERVER in x) ;; *) export MAIL_TYPE=smtp ;; esac; exec /bin/bash /entrypoint.sh"`
- **Health check:** /health

### Plugin daemon https://cdn.jsdelivr.net/gh/mikedepo/railway-template-assets@ff030029127cc39bd7212cc10fe36eefde0019ea/service-icons/dify.svg

- **Image:** langgenius/dify-plugin-daemon:0.6.12-local
- **Health check:** /health/check

### Scheduler https://cdn.jsdelivr.net/gh/mikedepo/railway-template-assets@ff030029127cc39bd7212cc10fe36eefde0019ea/service-icons/dify.svg

- **Image:** langgenius/dify-api:1.18.0

## Buckets

- **Bucket**

## Documentation

# Deploy and Host Dify (w/ admin setup) on Railway

Dify is an open-source builder for AI apps, agents and workflows. This template creates your admin from the deploy form and serves Dify on one URL, so you sign in as soon as it's up.

![Dify AI app builder on Railway](https://cdn.jsdelivr.net/gh/mikedepo/railway-template-assets@56db5a52196bf5c32e9b4cca84b5d81015729315/dify/banner.png)

## About Hosting Dify (w/ admin setup)

You get Dify 1.18, Postgres with pgvector, Redis and a Railway Bucket for files. Enter your email and a password when you deploy, open the Dify service's URL, sign in and add a model provider in Settings. It needs about 2.2 GB of memory: Trial, Hobby or Pro plan.

## Common Use Cases

- Chatbots on your own documents
- AI workflows with code steps
- Internal assistants and agents

## Dependencies for Dify (w/ admin setup) Hosting

- PostgreSQL (pgvector)
- Redis
- Railway Bucket

### Deployment Dependencies

- [Dify self-hosting with Docker Compose](https://docs.dify.ai/en/self-host/quick-start/docker-compose)
- [Dify environment variables](https://docs.dify.ai/en/self-host/configuration/environments)

### Implementation Details

![Architecture: you and your apps reach Dify through one public router; Web, API, Worker, Scheduler, plugin daemon, sandbox, Postgres and Redis stay on the private network; files go to a Railway Bucket](https://cdn.jsdelivr.net/gh/mikedepo/railway-template-assets@7e2ee686ad681e6e8bd12b517ca2ece719401143/dify/architecture.png)

Optional SMTP fields on the API service send invitations and password resets; SMTP needs a Railway Pro plan. Back up Postgres and the Bucket.

## Why Deploy Dify (w/ admin setup) 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 Dify (w/ admin setup) 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.


**Updated 2026-10-29:** SMTP plan note, Dify 1.18.0.


## Similar templates

- [Chat Chat](https://railway.com/deploy/-WWW5r) — Chat Chat, your own unified chat and search to AI platform.
- [Weaviate](https://railway.com/deploy/weaviate-1) — Vector database with hybrid search and an API key-protected API
- [Möbius v0.1 Personal AI OS](https://railway.com/deploy/mobius-v01-personal-ai-os) — Self-hosted AI agent that builds and runs apps for you, with memory.

Open this page in a browser: https://railway.com/deploy/dify-w-admin-setup
