Deploy and Host Alquimia Stack on Railway

Alquimia Stack is an AI agent runtime and builder environment for creating, configuring, and testing AI agents. It includes Alquimia Studio, Runtime, Router, registry storage, secrets support, vector search, object storage, and the supporting infrastructure needed to run a complete agent workflow on Railway.

About Hosting Alquimia Stack

Hosting Alquimia Stack on Railway deploys the core services required to run the Studio-based agent workflow end to end. The template provisions the web app, runtime API, router, Postgres, Redis, Qdrant, MinIO, Vault, and ORAS registry using Railway private networking. After deployment, users only need to provide required secrets and configure Lite authentication users in the Studio service. This setup is intended for demos, internal testing, customer trials, and lightweight production-like environments where a fast, reproducible deployment is more important than managing infrastructure manually.

Why Deploy

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 Alquimia Stack 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.

Common Use Cases

• Quickly deploy Alquimia Studio to create, configure, and test AI agents.
• Run customer demos or internal trials with a reproducible Railway environment.
• Validate Runtime, registry, secrets, vector storage, and object storage integrations without manually wiring infrastructure.

Dependencies for Alquimia Stack Hosting

• A Railway account with access to deploy templates.
• Alquimia Docker images and registry credentials configured in the template.
• Lite authentication users configured through the AUTH_LITE_USERS variable in the studio service after deployment.
• External LLM/model provider credentials, depending on the models you configure inside Studio.

Deployment Dependencies

• Railway Templates: https://docs.railway.com/templates
• Railway Private Networking: https://docs.railway.com/private-networking
• Railway Variables: https://docs.railway.com/variables
• Alquimia Docker Hub organization: https://hub.docker.com/u/alquimiaai

Implementation Details

After deploying the template, set the AUTH_LITE_USERS variable in the studio service.

Example value:

AUTH_LITE_USERS='[{"email":"admin@alquimia.ai","name":"Alquimia Admin","password_hash":""}]'