Meta tags:
description=Deploy your first project in minutes.;

Headings (most frequently used words):

your, manage, get, started, resources, upsun, project, connect, deploy, environments, add, with, documentation, index, on, this, page, before, you, begin, choose, path, start, from, zero, bring, repo, ai, agents, quickly, what, next, scale, custom, domain, monitor, debug, core, concepts, configure, apps, services, build, run, projects, observability, metrics, integrations, troubleshooting, install, the, cli, create, first, config, file, set, cpu, ram, disk, push, and, go, live, develop, locally, git, provider, optional,

Text of the page (most frequently used words):
upsun (42), your (26), and (18), the (16), #project (13), cli (11), guide (11), type (10), resources (9), you (9), install (9), page (8), add (8), live (8), full (8), myapp (8), #deploy (8), services (8), get (8), started (8), github (7), push (7), build (7), git (7), config (7), this (6), create (6), yaml (6), upstream (6), from (6), overview (6), documentation (5), configure (5), manage (5), for (5), connect (5), app (5), with (5), https (5), routes (5), first (5), using (4), developer (4), metrics (4), application (4), development (4), optional (4), run (4), environment (4), set (4), python (4), php (4), applications (4), file (4), copy (4), reference (3), docs (3), home (3), cpu (3), ram (3), disk (3), environments (3), that (3), integrations (3), setup (3), npm (3), open (3), locally (3), node (3), http (3), default (3), hooks (3), console (3), new (3), start (3), zero (3), path (3), choose (3), apps (3), free (3), before (3), are (2), assistant (2), platform (2), powered (2), linkedin (2), youtube (2), about (2), blog (2), api (2), tutorials (2), logs (2), data (2), production (2), domain (2), custom (2), preview (2), workflow (2), have (2), deployment (2), these (2), what (2), next (2), source (2), repository (2), link (2), auto (2), every (2), bitbucket (2), gitlab (2), provider (2), tunnel (2), local (2), develop (2), configuration (2), commit (2), postgresql (2), txt (2), database (2), below (2), init (2), runtime (2), scratch (2), account (2), scoop (2), com (2), tap (2), main (2), follow (2), steps (2), deploying (2), already (2), quickly (2), agents (2), deploys (2), repo (2), pick (2), begin (2), minutes (2), how (2), settings (2), search (2), trial (2), index (2), responses, generated, may, contain, mistakes, built, hosted, mintlify, careers, pricing, company, support, community, changelog, introduction, yes, was, helpful, last, modified, august, 2026, view, performance, monitor, debug, ssl, certificates, adjust, allocation, match, needs, scale, branches, now, explore, key, topics, make, most, step, can, continue, directly, recommended, team, workflows, automation, myorg, integration, mirror, tethered, dev, resource, size, pip, requirements, mariadb, composer, nodejs, uses, such, caching, service, also, generates, executable, script, see, details, generate, which, defines, login, then, log, homebrew, bucket, bash, raw, githubusercontent, installer, fssl, curl, brew, windows, linux, wsl, macos, operating, system, fast, possible, creating, existing, want, appropriate, card, above, instead, building, llm, mcp, servers, got, one, bring, yet, spin, situation, matches, yours, take, straight, right, basic, command, line, familiarity, installed, supported, java, ruby, net, sign, need, cloud, hosting, builds, scales, automatically, walks, through, installing, seeing, entire, process, takes, request, features, register, glossary, mounts, disks, 502, error, resolutions, troubleshooting, health, notifications, fastly, cdn, activity, scripts, infrastructure, observability, prerelease, object, storage, scaling, work, actions, backup, restore, security, compliance, administration, domains, projects, management, ssh, tools, variables, languages, common, tasks, effectively, works, core, concepts, stack, quickstart, navigation, watch, demo, ask, skip, content, use, discover, all, available, pages, exploring, further, fetch, complete, llms,

Text of the page (random words):
get started with upsun upsun developer documentation index fetch the complete documentation index at llms txt use this file to discover all available pages before exploring further skip to main content upsun developer home page search k ask assistant i console watch a demo free trial free trial search navigation get started get started with upsun home docs tutorials ai api cli blog get started quickstart setup guide pick a stack core concepts how upsun works workflow overview using upsun effectively common tasks configure apps services configure apps languages services routes build deploy run build and deploy local development variables development tools ssh database management manage projects overview project settings custom domains administration security compliance manage environments overview backup restore environment settings environment actions manage resources overview how resources work configure resources scaling object storage prerelease observability metrics overview infrastructure metrics application metrics logs integrations overview source integrations activity scripts fastly cdn health notifications troubleshooting 502 error resolutions development disks mounts resources glossary data register request features on this page before you begin choose your path get started quickly install the upsun cli create your first project add your config file set cpu ram disk push and go live develop locally connect your git provider optional what s next get started get started with upsun copy page copy page deploy your first project in minutes copy page copy page upsun is a cloud hosting platform that builds deploys and scales your applications automatically this guide walks you through deploying your first project from installing the cli to seeing your app live in production the entire process takes about 10 15 minutes before you begin you need an upsun account sign up for free a supported runtime node js php python go java ruby or net git installed locally basic command line familiarity choose your path pick the situation that matches yours and we ll take you straight to the right guide start from zero no project yet install the cli spin up a new project and deploy your first app bring your project got an app add one yaml file to your repo push to upsun and you re live connect your repo already on github link github gitlab or bitbucket every pr auto deploys to a live preview deploy ai agents building with ai deploy ai agents llm powered apps or mcp servers get started quickly the steps below follow the start from zero path creating a new project from scratch and deploying it to upsun if you already have an existing application or want to connect a git repository choose the appropriate card above instead follow these steps to go from zero to a live upsun deployment as fast as possible 1 install the upsun cli install the cli for your operating system macos linux wsl windows brew install upsun tap upsun cli curl fssl https raw githubusercontent com upsun cli main installer sh bash scoop bucket add upsun https github com upsun homebrew tap git scoop install upsun then log in to your upsun account upsun login full setup guide cli reference 2 create your first project create a new upsun project using the console create project start from scratch or the cli upsun project create full guide open console 3 add your config file run upsun init to generate upsun config yaml which defines your app s runtime services and routes if your project uses services such as a database or caching service upsun init also generates an executable environment script see the full guide below for details node js php python upsun config yaml applications myapp type nodejs 22 hooks build npm install npm run build services db type postgresql 16 routes https default type upstream upstream myapp http upsun config yaml applications myapp type php 8 3 hooks build composer install services db type mariadb 11 4 routes https default type upstream upstream myapp http upsun config yaml applications myapp type python 3 12 hooks build pip install r requirements txt services db type postgresql 16 routes https default type upstream upstream myapp http full guide node js php python 4 set cpu ram disk configure resources for your app with upsun resources set upsun resources set size myapp 1 full guide resource docs 5 push and go live commit your configuration and push to deploy git add upsun config yaml git commit m add upsun configuration upsun push full guide 6 develop locally open a tunnel to connect your local environment to live upsun services upsun tunnel open npm run dev full guide tethered setup 7 connect your git provider optional optional link github gitlab or bitbucket to mirror build and auto deploy on every push upsun integration add type github repository myorg myapp this step is optional you can continue using upsun push directly source integrations are recommended for team workflows and ci cd automation full guide what s next now that you have a live deployment explore these key topics to make the most of upsun manage environments create branches preview environments and manage your development workflow scale resources adjust cpu ram and disk allocation to match your application s needs add a custom domain configure your production domain and ssl certificates monitor debug view logs metrics and application performance data last modified on august 7 2026 was this page helpful yes no introduction upsun developer home page github youtube x linkedin docs documentation tutorials api reference cli reference resources changelog upsun blog community support company about pricing careers github youtube x linkedin powered by this documentation is built and hosted on mintlify a developer documentation platform assistant responses are generated using ai and may contain mistakes