Getting started
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.
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
- Click Connect GitHub. Livops is installed as a GitHub App and sees only the repositories you select.
- Choose a repository and branch. If you don’t pick a branch, the repository’s default branch is used.
- 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.
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 rootwon’t start. - The image must be no larger than 2 GiB and pull within 5 minutes.
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.appURL 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 explains it. The old version keeps running.