---
title: "Deploy Norish"
description: "Self-hosted recipe app: import, meal plans, shared grocery lists"
category: "Other"
url: https://railway.com/deploy/deploy-norish-family-recipe-app
---

# Deploy Norish

Self-hosted recipe app: import, meal plans, shared grocery lists

**[Deploy Norish on Railway](https://railway.com/template/deploy-norish-family-recipe-app)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/deploy-norish-family-recipe-app/manifest.json

- **Creator:** onepush
- **Category:** Other

## Template content

### norish https://api.iconify.design/mdi/silverware-fork-knife.svg

- **Image:** norishapp/norish:v0.27.0-beta
- **Health check:** /api/v1/health/live
- **Public domain:** Yes

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

- **Image:** postgres:17-alpine

### obscura https://api.iconify.design/mdi/web.svg

- **Image:** norishapp/obscura:0.2.7-norish.1

### valkey https://devicons.railway.app/redis

- **Image:** valkey/valkey:9-alpine
- **Start command:** `sh -c 'exec valkey-server --requirepass "$VALKEY_PASSWORD" --appendonly yes --dir /data --bind "* -::*"'`

## Documentation

# Deploy and Host self hosted Norish (Other) on Railway

This template deploys Norish, a self-hosted family recipe app, as independent community packaging of norish-recipes/norish v0.27.0-beta (AGPL-3.0). The upstream app is beta. It is not affiliated with or endorsed by Norish.

## About Hosting Norish open-source software on Railway (self hosted Norish template)

This template runs the unmodified upstream images for Norish v0.27.0-beta, which is beta software, with Postgres for recipes and accounts, Valkey for realtime events, and Obscura for headless-browser recipe rendering.

Railway handles provisioning, the private network between services, generated passwords and tokens, and the public domain on port 8080.

## Why Deploy Norish, the self-hosted family recipe app on Railway

Self-hosting Norish on Railway keeps your family's recipes, meal plans and grocery lists in your own project instead of a hosted recipe site.

Railway provisions the four services, the private network and the public domain on port 8080, so you do not have to assemble the stack on a VPS yourself.

### Railway vs Other Hosting Providers and VPS for Norish self hosting

Running Norish yourself means choosing where the app and its services live, and this table compares Railway with three common options.

| Provider | What You Get with Railway | What You Get with the Other Provider |
| --- | --- | --- |
| DigitalOcean | Four services from one template, with generated secrets and private networking. | A droplet you configure yourself, including OS, Docker and backups. |
| AWS | The same services wired together, with no networking or IAM setup on your side. | Broad control over networking and storage, with more setup work. |
| Hetzner | A managed deployment path that handles containers and health checks. | Low-cost VPS hardware where you manage Docker Compose and updates. |

Pick the option that matches how much infrastructure you want to manage.

## Common Use Cases for hosted Norish

- **Family recipe box:** Keep a shared collection of recipes that everyone in the household can open and edit from their own phone or laptop, with data stored in the bundled Postgres database.
- **Weekly meal planning:** Lay out dinners on a calendar so the week's plan lives in one place instead of scattered notes and screenshots.
- **Shared grocery lists:** Build a grocery list from the meal plan and let several people check items off, with live updates pushed through Valkey so changes appear quickly on other devices.
- **Recipe imports from the web:** Save recipes from websites, videos or photos, though URL import depends on Obscura being reachable over the private network, which was not confirmed in testing.

## Dependencies for Norish Docker hosted on Railway

This template runs four services.

### Deployment Dependencies for Managed Norish Service

- **norish:** public on port 8080, volume at /app/uploads, health check /api/v1/health/live (timeout 300 seconds), restart policy Always.
- **postgres:** private, postgres:17-alpine, volume /var/lib/postgresql, restart policy On Failure.
- **valkey:** private, valkey/valkey:9-alpine, volume /data, restart policy On Failure.
- **obscura:** private, norishapp/obscura:0.2.7-norish.1, no volume, restart policy On Failure.

Keep one replica of each service, because the volumes hold local persistent state.

### Implementation Details for Norish

This packaging runs unmodified upstream images directly: norishapp/norish:v0.27.0-beta, postgres:17-alpine, valkey/valkey:9-alpine, and norishapp/obscura:0.2.7-norish.1. The packaging repository holds docs and railway.toml only. Valkey starts with a generated password and append-only persistence. Obscura is wired at a private WebSocket address with a shared CDP token, but private reachability from Norish to Obscura was not confirmed, so do not assume URL recipe import works out of the box. The tested public port is 8080.

The template defines nine variables, all generated or referenced:

- **AUTH_URL:** the Railway HTTPS domain. Update it for a custom domain.
- **DATABASE_URL:** built from the postgres private domain and password.
- **MASTER_KEY:** base64 of 32 bytes. Keep it stable.
- **VALKEY_URL:** built from the valkey private domain and password.
- **OBSCURA_ENDPOINT:** the private address of obscura.
- **OBSCURA_CDP_TOKEN:** shared between norish and obscura.
- **POSTGRES_PASSWORD:** the generated postgres password.
- **VALKEY_PASSWORD:** the generated Valkey password.

## How does Norish compare against other tools

### Norish vs a hosted recipe site (Hosted Recipe Site Alternative)

- **Data Ownership:** Norish runs in your own Railway project, so recipes, meal plans and grocery lists stay in your Postgres database and uploads volume.
- **Sharing Model:** Norish suits a family or small group sharing one instance, with a live grocery list synced across devices.
- **Recipe Import:** A hosted site often imports URLs out of the box. In Norish, URL import depends on Obscura, and private reachability to it was not confirmed, so do not assume it works.
- **Upkeep:** A hosted site handles updates for you. With Norish you run the upstream beta release yourself and choose when to change it.

### Norish vs keeping recipes in documents (Documents Alternative)

- **Structure:** Norish stores recipes as structured data with calendar meal planning, while documents keep recipes as free text that is harder to search.
- **Shared Lists:** Norish keeps a grocery list synced across users, whereas documents usually need manual copying or re-sharing.
- **Setup Effort:** A document needs no server and is quicker for a handful of recipes. Norish asks you to run four services and keep MASTER_KEY stable.
- **Backups:** Documents are easy to copy. For Norish, back up the uploads volume, the Postgres volume, the Valkey volume and MASTER_KEY.

### Norish with Docker vs Railway (Docker Self Hosting Alternative)

- **Setup:** Running the upstream stack with Docker means writing the compose file and wiring services yourself. This template deploys the four services with generated secrets and no inputs.
- **Control:** Docker on a server gives full control over networking, storage and updates. Railway manages much of that, which is convenient but means relying on its platform.
- **Persistence:** Both approaches need volumes for uploads, Postgres and Valkey. Keep one replica of each service.
- **Cost Model:** Docker on a VPS is a fixed server cost, while Railway is usage-based, so the bill depends on resource use.

## How to use Norish on Railway?

1. Open the public Railway domain for the norish service and register the first account right away. That first account becomes the server owner and admin, so do this before anyone else can.
2. Sign in and start adding recipes, meal plans or grocery lists.
3. Do not assume recipe import from website URLs works out of the box. Obscura reachability over the private network was not confirmed, so test one URL import before relying on it.
4. If you add a custom domain, update AUTH_URL to match it, or sign-in redirects will break.
5. Keep MASTER_KEY stable. Changing it can make stored secrets unreadable.
6. Keep one replica of each service. Local persistent state in postgres and valkey does not work well with multiple replicas.
7. Norish checks its health at /api/v1/health/live, with a 300 second timeout, so allow time for the first boot to finish.

```
Health check path: /api/v1/health/live
Health check timeout: 300 seconds
```

## How to self host Norish on other VPS Services (Norish self hosting guide)

### Clone the Repository

Start by cloning the upstream repository and checking out the v0.27.0-beta tag so you run the same release this template uses.

```bash
git clone https://github.com/norish-recipes/norish.git
cd norish
git checkout v0.27.0-beta
```

### Install Dependencies

Install Docker and Docker Compose on your VPS.

```bash
docker --version
docker compose version
```

### Configure Environment Variables

Set the same variables this template uses.

```bash
export AUTH_URL=https://your-domain
export MASTER_KEY=$(openssl rand -base64 32)
export POSTGRES_PASSWORD=your-postgres-password
export VALKEY_PASSWORD=your-valkey-password
```

### Start the Norish Application

Bring the stack up with the documented upstream flow for the app, Postgres, Valkey and optional Obscura. See the upstream repository for the compose file and commands.

## Pricing and License of Norish (Norish pricing)

Norish is licensed under AGPL-3.0, so the software is open source and free to self-host.

## Norish hosted vs self hosted comparison (Pricing, features, costs, and more)

This template packages the AGPL-3.0 beta software, and no hosted plan prices are quoted here.

### Monthly cost of self hosting Norish on Railway

Railway bills on usage, so the monthly cost depends on RAM and CPU across the four services, the size of the volumes, and how long they run.

### System Requirements for Hosting Norish on a VPS

On a VPS you run the same four services: the Norish app, Postgres, Valkey and Obscura.

## Frequently Asked Questions (FAQs)

### Is this beta software?

Yes. The pinned image and tag are norishapp/norish:v0.27.0-beta, and this template treats the upstream app as beta software.

### Who is the first admin?

The first account you register on your new Norish URL becomes the server owner and admin.

### Does URL recipe import work out of the box?

Do not assume it does. URL import depends on Obscura, and reachability over the private network was not confirmed in testing. Try one import yourself before you rely on it.

### What should I back up?

Back up the /app/uploads volume, the Postgres volume at /var/lib/postgresql, the Valkey volume at /data, and your MASTER_KEY.

### Is this affiliated with Norish?

No. This is independent community packaging of norish-recipes/norish v0.27.0-beta (AGPL-3.0), and it is not affiliated with or endorsed by Norish.


## 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/deploy-norish-family-recipe-app
