Quick Start: Deploy your first app
This guide takes you from a fresh invite to a live app at https://<your-slug>.run.uploy.eu.
You will need:
- An accepted uploy invite (see Join the waitlist).
- A GitHub account.
- A repository uploy can build. If you don’t have one, fork uploy-examples/hello-node — a minimal Node.js app.
Time: About 5 minutes.
1. Sign in
Section titled “1. Sign in”Go to app.uploy.eu and click Sign in with GitHub. Approve the OAuth prompt.
After sign-in you land on the Projects page.
2. Create a project
Section titled “2. Create a project”A project is a folder that groups related apps and databases. Click New project, give it a name (for example personal), and submit.
3. Create an app from a GitHub repository
Section titled “3. Create an app from a GitHub repository”From the project detail page, click New app.
- Click Connect GitHub. If this is your first app, uploy asks you to install the GitHub App on your account or organization. Approve it.
- Select the repository.
- Choose a branch (defaults to the repository’s default branch).
- Name the app. The default slug determines your URL:
<slug>.run.uploy.eu. - Click Create app.
uploy immediately queues the first deployment.
4. Watch the build
Section titled “4. Watch the build”You are redirected to the Deployment logs page. You will see, in order:
Cloning repository…- Nixpacks detection (
Detected Node.js, for example). - Build steps streamed live.
Pushing image…Applying Kubernetes resources…Deployment ready.
If the build fails, see Build failed.
5. Visit your app
Section titled “5. Visit your app”When the deployment finishes, the app detail page shows the URL. Open https://<slug>.run.uploy.eu in a new tab — you should see your app running.
6. Redeploy with a git push
Section titled “6. Redeploy with a git push”Commit anything in your repository and push to the branch you selected. A new deployment starts automatically. Watch it from the app’s Deployments tab.