LofentaLofenta/Docs

Getting started

Quickstart

Deploy your first app to Lofenta in under two minutes.

Prerequisites

  • A GitHub or GitLab account
  • A repository with a web app (any language)
  • A Lofenta account (free)

Step by step

1

Sign in

Go to /login and click Continue with GitHub or Continue with GitLab. Lofenta uses OAuth to identify you and read your repositories.

We only request read:user and user:email scopes on first login. Repository access is granted per-project when you paste a repo URL or pick from the repo browser.
2

Create a project

From the dashboard, click New Project. Fill in:

  • Project name A display name for the dashboard. Also generates your subdomain.
  • Repository GitHub: paste owner/repo (e.g. acme/my-app). GitLab: paste the full URL (e.g. https://gitlab.com/group/project). Leave blank to deploy from a Dockerfile only.
  • Branch The branch to watch for pushes. Defaults to main.

Click Create project. The first build starts immediately.

3

Watch the build

You land on the project page. The deployment card shows the current phase:

queuedWaiting for a build runner
cloninggit clone in progress
installingnpm/pip/go mod install
buildingRunning your build command
startingContainer booting
health_checkPolling /_health, /health, /
liveTraffic is flowing
4

Open your app

Once status is live, your app is accessible at:

https://<project-slug>.lofenta.app

To use a custom domain, see the Custom domains guide.

Continuous deployment

When you connect a GitHub or GitLab repository, Lofenta installs a push webhook on it automatically. From then on, every push to the tracked branch triggers a new deployment with no extra setup.

If your GitHub token lacks the admin:repo_hook scope, automatic webhook setup is skipped and you can add the webhook manually, pointing it at https://lofenta.com/api/webhooks/github. For GitLab, the equivalent endpoint is https://lofenta.com/api/webhooks/gitlab. You can also trigger a deploy any time with the Redeploy button on the project page, which builds the latest commit on the tracked branch.

Next

Deployments

Lifecycle, logs, rollbacks