# Ways to deploy

> Create a project four ways — from a GitHub repository, by uploading a folder, from a Docker image, or from a ready-made template.

Source: https://livops.dev/en/docs/deploy

In the **New project** dialog, you choose a source. Whichever you pick, the next steps are the same: Livops detects your code, suggests commands, builds it and gives you a URL.

## From GitHub

1. Click **Connect GitHub**. Livops is installed as a GitHub App and sees only the repositories you select.
2. Choose a repository and branch. If you don't pick a branch, the repository's default branch is used.
3. For a monorepo, specify the folder the project lives in (for example `apps/web`).

Every `git push` to that branch starts a new deploy. Pushes to other branches don't deploy.

> GitLab is supported too: connect a GitLab webhook in the project settings.

You can also enable a separate preview environment for pull requests — see [Environments](https://livops.dev/en/docs/environments).

## Upload a folder

If your code isn't on GitHub, drop a folder or a `.zip` file into the browser.

- At most **200 MiB** and **5000 files**.
- Uploads not yet attached to a project are kept up to 1 GiB total per account.
- These are dropped automatically: `.git`, `node_modules`, `venv`, `.venv`, `__pycache__`, `.next`, `.nuxt`, `target`, `.gradle`, `.idea`, `.vscode`, `vendor`, `.DS_Store`, `__MACOSX`.

To ship the next version, upload the folder again — the deploy button picks up the new folder.

## From a Docker image

You can run a ready-made image directly.

- **Public** images only, from three registries: `docker.io`, `ghcr.io`, `quay.io`. A name without a registry is treated as Docker Hub: `nginx:1.27` → `docker.io/library/nginx:1.27`.
- You specify the port your app listens on; it must be **1024 or higher**.
- The container runs as user 1000 (uid 1000), without any Linux capabilities. An image built with `USER root` won't start.
- The image must be no larger than 2 GiB and pull within 5 minutes.

```text
ghcr.io/owner/app:1.4.2
```

## From a template

A template is a project with code, a database and the connections between them ready to go. Created in one click.

| Template | Includes |
| --- | --- |
| Next.js (static) | A statically exported Next.js site, free |
| Express + PostgreSQL | Node API and a database |
| FastAPI + PostgreSQL | Python API and a database |
| Vite + React and FastAPI | Site, API and PostgreSQL |
| aiogram 3 bot + Redis | Telegram bot and Redis |

Ready-made apps are available too: **n8n**, **Uptime Kuma**, **Metabase**, **Directus**.

## After the build

- The project gets a `<name>.livops.app` URL and HTTPS automatically.
- Recent versions are kept — roll back to a previous one in one click from the **Deploys** list.
- If a build fails, the log shows why, and the [assistant](https://livops.dev/en/docs/assistant) explains it. The old version keeps running.
