Deploy utopia

Deploy and Host Utopia on Railway

Utopia is an open-source enterprise knowledge world model for building governed, time-aware organizational intelligence. It combines an ontology-driven graph, hybrid full-text and vector search, document ingestion, temporal reasoning, conflict detection, auditability, and an integrated web console in one deployable service backed by PostgreSQL with pgvector.

About Hosting Utopia on Railway

Railway runs the Utopia web service from its published GHCR container image and provisions a PostgreSQL pgvector container alongside it. Private service networking connects the application to the database, while Railway provides HTTPS domain routing, managed deployments, logs, and restart policies.

Tech Stack

• Rust and Axum backend
• Svelte web console bundled in the container
• PostgreSQL 16 with pgvector
• Tantivy full-text indexing
• SQLx database migrations
• OpenAI-compatible model endpoint integrations

Why Deploy Utopia on Railway

Railway provides one-click infrastructure, private networking between services, automatic HTTPS, persistent volumes, environment variable management, and straightforward observability. This keeps the complete knowledge platform accessible without maintaining Kubernetes or a separate reverse proxy.

Common Use Cases

• Enterprise knowledge bases and governed document repositories
• Ontology and graph exploration
• Hybrid semantic and full-text search
• Auditable research and compliance workflows
• Agentic retrieval and model-assisted knowledge extraction
• Temporal reasoning and conflict review

Deployment Notes

The Utopia service listens on container port 1516 and exposes PORT=1516 for Railway routing. Its database URL references the private hostname of the utopia-db service. PostgreSQL data is persisted at /var/lib/postgresql/data; application files and indexes under /app/data are ephemeral unless an additional volume is attached. On first launch, open the generated domain and register an account; the first account becomes the administrator. Configure chat and embedding model endpoints in system settings before ingesting documents. Pin the application image version for production upgrades.

Dependencies for Utopia on Railway

Utopia requires a PostgreSQL 16 database with the pgvector extension. The application runs migrations automatically at startup and connects over Railway's private network.

Deployment Dependencies