---
title: "Deploy Redoc"
description: "Clean three-panel API reference docs from your OpenAPI definition"
category: "Other"
url: https://railway.com/deploy/redoc
---

# Deploy Redoc

Clean three-panel API reference docs from your OpenAPI definition

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

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

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

## Template content

### Redoc https://raw.githubusercontent.com/Redocly/redoc/redoc@3.2.0/config/docker/static/favicon.png

- **Source:** https://github.com/aalfath/redoc-railway-template
- **Health check:** /healthz
- **Public domain:** Yes

## Documentation

# Deploy and Host Redoc on Railway

Redoc is an open-source tool from Redocly that turns an OpenAPI definition into a clean, three-panel API reference: navigation on the left, documentation in the middle and request and response samples on the right. It also renders AsyncAPI definitions and GraphQL schemas, and has search and deep links to every operation.

## About Hosting Redoc

This template runs the official Redoc image (3.2.0, pinned by digest) as one service built from a public GitHub repo. nginx serves the Redoc page on port 8080, with a `/healthz` health check. Set `SPEC_URL` to your API definition: a public URL, or an address on Railway's private network such as `http://my-api.railway.internal:8000/openapi.json`. The service fetches the definition server-side and serves it from its own domain, so definitions without CORS headers still load. There is no database and no volume, because Redoc keeps nothing on the server. It deploys with Redocly's Museum sample until you set your own URL.

## Common Use Cases

* Publish public reference docs for a REST API from its OpenAPI file
* Give a team internal API docs for a service that runs on Railway's private network
* Preview an OpenAPI, AsyncAPI or GraphQL definition as rendered docs before a release

## Dependencies for Redoc Hosting

* An OpenAPI 2.0/3.x, AsyncAPI or GraphQL definition reachable over HTTP(S), publicly or on Railway's private network

### Deployment Dependencies

* Redoc source and releases: https://github.com/Redocly/redoc/releases/tag/redoc%403.2.0
* Official Docker image docs: https://github.com/Redocly/redoc/blob/main/config/docker/README.md
* Redoc configuration options: https://redocly.com/docs/redoc/v3.x/config
* Template repo: https://github.com/aalfath/redoc-railway-template

### Implementation Details

After deploy, open the service's Variables tab and set `SPEC_URL` to your definition, then redeploy. Docs re-read the definition on every page load, so they follow your API without a redeploy. Optional variables: `PAGE_TITLE` (tab title), `REDOC_OPTIONS` (extra attributes for the redoc tag, for example `hide-download-button="true"`), `PAGE_FAVICON`, `BASE_PATH` (serve under a path such as `docs`), `SPEC_PROXY=false` (let the browser fetch `SPEC_URL` directly) and `REDOC_TELEMETRY=true` (Redoc's anonymous usage data is off by default here). The proxy only passes GET requests for the definition and the `.yaml`, `.yml` or `.json` files beside or below it, without cookies or Authorization headers. The docs page is public: don't point it at a definition you need to keep private.

Updates: the template builds from `aalfath/redoc-railway-template`. When a new Redoc release is pinned there, Railway shows an update notice on your project; read the repo's CHANGELOG.md before you apply it.

## Why Deploy Redoc 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 Redoc 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/redoc
