Deploy and Host TerraInk on Railway

About Hosting

TerraInk is an open-source application for creating custom city map posters using OpenStreetMap data, MapLibre rendering, and a flexible styling and theming system. Railway provides a simple managed hosting environment for Docker-based applications, with public networking, HTTPS, and straightforward runtime configuration.

Tech Stack

• Frontend: React + TypeScript + Vite
• Build Toolchain: Bun
• Runtime Server: Nginx
• Deployment Method: Docker image on Railway

Why Deploy on Railway

• Supports Docker image deployment without source-build drift
• Allows pinned image versions for reproducible deployments
• Provides built-in HTTPS and public domain access
• Keeps runtime setup minimal with simple port-based routing
• Works well for static or semi-static web app hosting

Common Use Cases

• Personal or commercial city map poster generation
• City-themed print and merchandise products
• Geographic design exploration and visual prototyping
• Browser-based map styling and poster creation tools

Deployment Notes

• This deployment uses a prebuilt Docker image instead of building from source
• The pinned image digest improves deployment reproducibility
• The application listens on container port 80
• Railway should route HTTP traffic using PORT=80
• No persistent volume is required for the baseline deployment
• The image startup command is not overridden in this setup

Dependencies for TerraInk on Railway

Deployment Dependencies