// QUICK START

Deploy from GitHub in under 5 minutes

Prerequisites

  • A VPS with Docker and Docker Compose installed
  • A GitHub account
  • A project with a docker-compose.yml

1. Install Trangly

One-liner (Debian / Ubuntu / RHEL / Fedora / Alpine):

$ curl -fsSL https://raw.githubusercontent.com/udaypankhaniya/trangly/master/scripts/install.sh | sh

Or download a .deb or .rpm package directly from the v0.1.2 release.

2. Run Setup

$ trangly setup

This starts the Trangly daemon and opens the web dashboard on port 2880.

3. Connect GitHub

Open http://your-vps-ip:2880 and click Connect GitHub. The App Manifest flow handles OAuth automatically — no tokens to copy.

4. Add a Project & Push

Click Add Project, select your repository, and push a commit. Trangly will detect the webhook, clone, build, health-check, and swap automatically.