---
title: "Deploy CalendarForge Cloud"
description: "Self-hosted calendar API, date planning, PostgreSQL & Railway deployment"
category: "Starters"
url: https://railway.com/deploy/calendarforge-cloud
---

# Deploy CalendarForge Cloud

Self-hosted calendar API, date planning, PostgreSQL & Railway deployment

**[Deploy CalendarForge Cloud on Railway](https://railway.com/template/calendarforge-cloud)**

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

- **Creator:** Make a Calendar's Projects
- **Category:** Starters

## Template content

### CalendarForge Web

- **Source:** https://github.com/makeacalendar/make-a-calendar-calendarforge
- **Health check:** /api/v1/health
- **Public domain:** Yes

### Postgres https://devicons.railway.app/i/postgresql.svg

- **Image:** ghcr.io/railwayapp-templates/postgres-ssl:18

## Documentation

# Deploy and Host CalendarForge Cloud on Railway

CalendarForge Cloud is an independent open-source calendar planning studio and API by Ethan, maker of [Make a Calendar](https://make-a-calendar.com/). Version 0.1.0 provides Gregorian calendars, US observed holidays, business-day math, 4-4-5 retail periods, JSON/CSV/ICS exports, and PostgreSQL project APIs. Source: [GitHub](https://github.com/makeacalendar/make-a-calendar-calendarforge).

**Live resources:** [Open the CalendarForge demo](https://soothing-analysis-production-bd03.up.railway.app/) · [API and developer documentation](https://soothing-analysis-production-bd03.up.railway.app/docs) · [OpenAPI schema](https://soothing-analysis-production-bd03.up.railway.app/api/openapi) · [Health check](https://soothing-analysis-production-bd03.up.railway.app/api/v1/health) · [Public calendar resource directory](https://soothing-analysis-production-bd03.up.railway.app/resources).


## About Hosting CalendarForge Cloud
This template creates a Next.js web service and a private PostgreSQL database in your Railway workspace. Railway builds the web app from the public repository. The app's `DATABASE_URL` references the database's private connection. Enter a strong, unique `CALENDARFORGE_API_TOKEN` when Railway prompts you; keep it private and send it only over TLS. This token protects PostgreSQL project endpoints. Calendar events in the public demo are saved in the current browser and do not share the template deployment's database. Review your Railway plan and current usage before leaving services running.

## Common Use Cases
- View month grids, ISO week numbers, and observed US federal holidays.
- Count business days or add/subtract workdays.
- Review 4-4-5 retail periods.
- Export JSON, CSV, and ICS data.
- Save trusted operator projects through the token-protected API.
- Visit complementary [printable calendars](https://make-a-calendar.com/monthly-calendars), [business-day tools](https://make-a-calendar.com/business-days-calculator), [pay-period calendars](https://make-a-calendar.com/pay-period-calendar), [retail calendars](https://make-a-calendar.com/445-calendar), [iCalendar](https://make-a-calendar.com/ical-generator), and [date tools](https://make-a-calendar.com/date-tools).

## Dependencies for CalendarForge Cloud Hosting
- Railway web service built from the public GitHub repository.
- Railway PostgreSQL service connected over private networking.
- A strong, unique `CALENDARFORGE_API_TOKEN` for persisted project endpoints.

Railway provides the runtime and database. No external API is required.

## Why Deploy CalendarForge Cloud on Railway?
Run the source and PostgreSQL data in a Railway project you control. The template connects the web service and database and builds the app from source. Railway compute and database usage may consume credits based on your workspace plan and runtime.

## Release scope and conventions
This is a deployable v0.1.0 foundation, not a multi-user SaaS. The project API uses one shared bearer token and has no user accounts or workspace isolation. There is no background worker or PDF export. Confirm the documented Sunday-nearest-February-1 4-4-5 convention against your own fiscal policy. CalendarForge is separate from Make a Calendar and does not call its private services.


## Similar templates

- [open-excalidraw](https://railway.com/deploy/open-excalidraw) — Self-hostable collaborative drawing built on Excalidraw
- [caring-vibrancy](https://railway.com/deploy/caring-vibrancy) — Deploy and Host caring-vibrancy with Railway
- [Appsmith](https://railway.com/deploy/appsmith-1) — Low-code platform for internal tools, dashboards, and admin panels.

Open this page in a browser: https://railway.com/deploy/calendarforge-cloud