> ## Documentation Index
> Fetch the complete documentation index at: https://developer.upsun.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Upsun Cloud

> Docs, guides, and references for deploying and managing applications on Upsun Cloud — the platform for build, test, deploy, and run.

# Build on Upsun Cloud

Docs, guides, and references for deploying and managing applications on Upsun Cloud.

[Get Started](https://developer.upsun.com/docs/get-started.md)

[Browse Docs](https://developer.upsun.com/docs/core-concepts/index)

## Explore

Jump into the topics that matter to you.

> [card] [Quick Start](https://developer.upsun.com/docs/get-started.md)
>
> Deploy your first app step by step

> [card] [Framework Guides](https://developer.upsun.com/docs/get-started/stacks)
>
> Next.js, Django, Laravel, Symfony, and more

> [card] [Services & Databases](https://developer.upsun.com/docs/add-services)
>
> PostgreSQL, MySQL, Redis, and more

> [card] [Environments](https://developer.upsun.com/docs/environments.md)
>
> Branch, preview, and manage environments

> [card] [Observability](https://developer.upsun.com/docs/observability.md)
>
> Monitoring, metrics, and performance

> [card] [AI & Automation](https://developer.upsun.com/docs/get-started/ai)
>
> MCP servers, AI agents, and CLI tools

## What's New

NEW

Tutorial

### [Deploying a coding agent with opencode](https://developer.upsun.com/tutorials/ai/coding-agent.md)

Deploy opencode as a self-hosted AI coding agent with headless Chrome for web automation and performance testing.

Tutorial

### [Building a LangChain chatbot](https://developer.upsun.com/tutorials/ai/langchain-chatbot.md)

Build a documentation chatbot with Node.js, LangChain, and OpenAI, with prompt injection defense and streaming responses.

Tutorial

### [Building a RAG pipeline with Qdrant](https://developer.upsun.com/tutorials/ai/rag-pipeline.md)

Replace context stuffing with vector search using Qdrant for 25x lower cost per query.

## Deploy Your Stack

Get started with your favorite framework.

> [card] [Next.js](https://developer.upsun.com/docs/get-started/stacks/nextjs.md)
>
> Full-stack React with SSR

> [card] [Django](https://developer.upsun.com/docs/get-started/stacks/django.md)
>
> Python web framework

> [card] [Laravel](https://developer.upsun.com/docs/get-started/stacks/laravel)
>
> PHP framework for artisans

> [card] [Express](https://developer.upsun.com/docs/get-started/stacks/express)
>
> Minimal Node.js framework

> [card] [Symfony](https://developer.upsun.com/docs/get-started/stacks/symfony)
>
> Enterprise PHP framework

> [card] [Flask](https://developer.upsun.com/docs/get-started/stacks/flask.md)
>
> Lightweight Python framework

> [card] [WordPress](https://developer.upsun.com/tutorials/wordpress)
>
> Popular CMS platform

> [card] [All Frameworks →](https://developer.upsun.com/docs/get-started/stacks)
>
> Go, Ruby, Rust, Elixir, Java

## 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 installweb: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 Cloud config"

\$
git push upsun main

Building application 'myapp'...Provisioning services...

✓
Deployment complete

[https://main-abc123.us-5.platformsh.site/](https://main-abc123.us-5.platformsh.site/)

1ConfigureDefine apps & services in YAML

2CommitAdd to version control

3DeployPush and go live

## Tutorials: AI Use Cases

LLM based applications and workflows

> [card] [LangChain Chatbot](https://developer.upsun.com/tutorials/ai/langchain-chatbot.md)
>
> Build a conversational chatbot with Node.js and LangChain, deployed on Upsun Cloud

> [card] [RAG Pipeline](https://developer.upsun.com/tutorials/ai/rag-pipeline.md)
>
> Create a retrieval-augmented generation pipeline with Python and Qdrant for vector search

> [card] [Coding Agent](https://developer.upsun.com/tutorials/ai/coding-agent.md)
>
> Deploy a self-hosted coding agent using opencode on Upsun Cloud with proper workspace mounts

> [card] [News Digest](https://developer.upsun.com/tutorials/ai/news-digest.md)
>
> Summarize daily news from free APIs using AI, output to a static page

> [card] [Form Processing](https://developer.upsun.com/tutorials/ai/form-processing.md)
>
> Classify and extract fields from unstructured text like support tickets using AI

> [card] [eCommerce Insights](https://developer.upsun.com/tutorials/ai/ecommerce-insights.md)
>
> AI-powered business intelligence assistant that queries an ecommerce database using natural language

## Platform Features

Everything you need to build and scale.

> [card] [Clone environments instantly](https://developer.upsun.com/docs/environments.md)
>
> Work with full production-like environments, including data.

> [card] [Deploy with Git](https://developer.upsun.com/docs/get-started/here/setup.md)
>
> Infrastructure, services, and code defined together.

> [card] [Autoscale automatically](https://developer.upsun.com/docs/manage-resources/autoscaling.md)
>
> Handle traffic spikes without manual intervention.

> [card] [Add services easily](https://developer.upsun.com/docs/add-services)
>
> Databases, caches, queues, and more in a few lines of config.

> [card] [Deploy with zero downtime](https://developer.upsun.com/docs/core-concepts/build-deploy.md)
>
> Atomic deployments and instant rollbacks.

> [card] [Debug with built-in observability](https://developer.upsun.com/docs/observability.md)
>
> Logs, metrics, traces, and profiling included.

## Community & Resources

Connect, learn, and get inspired.

> [card] [Example Projects](https://github.com/orgs/upsun/repositories?q=topic%3Aupsun-example)
>
> Browse example projects on GitHub with ready-to-deploy configurations

> [card] [Community Forum](https://community.upsun.com)
>
> Get help, share projects, and connect with developers

> [card] [Agency Partners](https://upsun.com/agency-hosting-partner/)
>
> Build long-term partnerships and grow your agency

## Ready to Deploy?

Get your application live in production.

[Start Building →](https://developer.upsun.com/docs/get-started.md)

[Deploy Demo Project](https://console.upsun.com/projects/create-project)

✓ Git push to deploy
✓ Zero-downtime deploys
✓ Production-ready


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.