---
title: "Deploy vizier"
description: "The one agent-first platform for your entire business stack"
category: "Other"
url: https://railway.com/deploy/vizier
---

# Deploy vizier

The one agent-first platform for your entire business stack

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

- **Creator:** Kaze's Projects
- **Category:** Other
- **Total deploys:** 1

## Template content

### junkiez/vizier:latest https://raw.githubusercontent.com/Junkiez/vizier-docs/main/VizierWhite.png

- **Image:** ghcr.io/junkiez/vizier:latest
- **Health check:** /api/v1/health
- **Public domain:** Yes

## Documentation

# Deploy and Host Vizier on Railway

Vizier is a self-hosted, agent-first platform for building internal software end to end. Collections with typed fields, validation and per-role access; JavaScript functions; server-rendered pages; document templates; scheduled jobs; email and messaging integrations — one binary, one admin UI, and an MCP endpoint so AI agents can build and operate it directly.

## About Hosting Vizier

Vizier ships as a single container with no external services to run. Deployment is one service plus a persistent volume mounted where the data lives. You set a public URL and an auth secret, and open the app: the first run walks you through creating the admin account and company profile. Because state is a file on disk, run a single replica and scale vertically; automatic off-site backups to any S3-compatible bucket are built in.

## Common Use Cases

- Internal business systems — orders, inventory, CRM and receivables — with typed collections, validation rules, record history and per-role permissions, without writing a backend
- Form, webhook and API endpoints backed by JavaScript functions that read and write collections, send email, render PDFs and call out to other services
- Agent-built internal tools: point Claude or any MCP client at the instance and have it create collections, functions, pages and scheduled jobs directly
- Customer-facing content and landing pages rendered server-side from the same data, with scheduled reports and notifications on top

## Dependencies for vizier Hosting

- A persistent volume for the data directory (databases, uploaded files and backups all live there)
- Nothing else — no external database, cache or queue is required

### Deployment Dependencies

#### Required
- [Railway volumes](https://docs.railway.com/reference/volumes) — persistent storage for the data directory

#### Optional
Everything below is optional and configured in the admin UI after the first run — none of it is needed to deploy, and you only supply credentials for the integrations you actually use.

- [OpenAI](https://platform.openai.com/docs)

- [OpenRouter](https://openrouter.ai/docs)

- [Groq](https://console.groq.com/docs)

- [xAI](https://docs.x.ai)

- [Ollama](https://ollama.com) — for a local or self-hosted model

- [Model Context Protocol](https://modelcontextprotocol.io) — connect Claude or any MCP client to build and operate the instance

- Any SMTP provider — outbound mail

- [Resend](https://resend.com/docs) — outbound mail over the Resend API

- Any IMAP mailbox — inbound mail into the shared inbox

- [Telegram Bot API](https://core.telegram.org/bots/api)

- [X (Twitter) API](https://developer.x.com) — direct messages; paid tier

- [X (Twitter)](https://developer.x.com)

- [Amazon S3](https://docs.aws.amazon.com/s3/)

- [MinIO](https://min.io/docs/minio/linux/index.html)

### Implementation Details

The image listens on `:8080` and stores everything under `/app/data`, which is where the volume should be mounted.

| Variable | Required | Notes |
| --- | --- | --- |
| `PUBLIC_URL` | yes | The instance's public URL. Startup fails if empty. |
| `AUTH_SECRET` | yes | Signs sessions. Ships with a placeholder — set a strong value. |
| `DATA_DIR` | no | Defaults to `/app/data`. Mount the volume here. |
| `HTTP_ADDR` | no | Defaults to `:8080`. |

Healthcheck:

```
GET /api/v1/health  →  200  {"status":"ok"}
```
Admin ui lives under /_ path

Optional integrations are configured in the admin UI rather than by environment variable: SMTP and Resend for email, Telegram and other messaging channels, AI providers, and scheduled S3 backups.

## Why Deploy vizier 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 vizier 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) — [Jul'26] Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — A Self-Hosted & Modern Roleplaying Platform
- [Letta Code Remote](https://railway.com/deploy/letta-code-remote) — Run a Letta Code agent 24/7. No inbound ports, just deploy.

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