Build on Upsun
Docs, guides, and references for deploying and managing applications on the Upsun platform.
Explore
Jump into the topics that matter to you.
Quick Start
Deploy your first app step by step
Framework Guides
Next.js, Django, Laravel, Symfony, and more
Services & Databases
PostgreSQL, MySQL, Redis, and more
Environments
Branch, preview, and manage environments
Observability
Monitoring, metrics, and performance
AI & Automation
MCP servers, AI agents, and CLI tools
What’s New
NEW
Tutorial
Deploying a coding agent with opencode
Deploy opencode as a self-hosted AI coding agent with headless Chrome for web automation and performance testing.
Tutorial
Building a LangChain chatbot
Build a documentation chatbot with Node.js, LangChain, and OpenAI, with prompt injection defense and streaming responses.
Tutorial
Building a RAG pipeline with Qdrant
Replace context stuffing with vector search using Qdrant for 25x lower cost per query.
Deploy Your Stack
Get started with your favorite framework.
Configure. Commit. Deploy.
Define your infrastructure in YAML, then deploy with a single push.
.upsun/config.yaml
applications:
myapp:
type: nodejs:22
hooks:
build: npm install
web:
commands:
start: npm start
services:
database:
type: postgresql:16
Deploy with Git
# Add your config
$git add .upsun/config.yaml
# Commit and push
$git commit -m Add Upsun config
$git push upsun main
Building application ‘myapp’…
Provisioning services…
✓Deployment complete
1
Configure
Define apps & services in YAML
2
Commit
Add to version control
3
Deploy
Push and go live
Tutorials: AI Use Cases
LLM based applications and workflows
LangChain Chatbot
Build a conversational chatbot with Node.js and LangChain, deployed on Upsun
RAG Pipeline
Create a retrieval-augmented generation pipeline with Python and Qdrant for vector search
Coding Agent
Deploy a self-hosted coding agent using opencode on Upsun with proper workspace mounts
News Digest
Summarize daily news from free APIs using AI, output to a static page
Form Processing
Classify and extract fields from unstructured text like support tickets using AI
eCommerce Insights
AI-powered business intelligence assistant that queries an ecommerce database using natural language
Platform Features
Everything you need to build and scale.
Clone environments instantly
Work with full production-like environments, including data.
Deploy with Git
Infrastructure, services, and code defined together.
Autoscale automatically
Handle traffic spikes without manual intervention.
Add services easily
Databases, caches, queues, and more in a few lines of config.
Deploy with zero downtime
Atomic deployments and instant rollbacks.
Debug with built-in observability
Logs, metrics, traces, and profiling included.
Community & Resources
Connect, learn, and get inspired.
Ready to Deploy?
Get your application live in production.
✓ Git push to deploy✓ Zero-downtime deploys✓ Production-ready