- Updated: March 16, 2026
- 6 min read
Introducing TowlionMicro‑PaaS: A Comprehensive Overview
TowlionMicro‑PaaS instantly transforms a single Debian server into a full‑featured micro‑PaaS, letting developers push code to GitHub and get a production‑ready SaaS app deployed in minutes.
Why Micro‑PaaS Matters for Modern SaaS Development
In the era of rapid iteration, SaaS entrepreneurs and dev‑ops teams need a deployment solution that eliminates the overhead of managing multiple cloud services while still offering the flexibility of a full‑stack platform. Micro‑PaaS bridges that gap by providing a lightweight, self‑hosted environment that behaves like a commercial PaaS but runs on your own hardware. The original Towlion project showcases exactly how this can be achieved with a handful of open‑source tools.
Feature Overview of TowlionMicro‑PaaS
Git‑Centric Control Plane
All configuration lives in GitHub. No separate dashboard, no proprietary API—just git push to trigger builds, previews, and production releases. Opening a pull request automatically spawns a preview environment, and closing it tears the preview down.
Multi‑App Hosting on One Server
Each app receives its own sub‑domain, isolated Docker containers, dedicated PostgreSQL schema, Redis namespace, and MinIO bucket. This isolation mirrors the experience of a multi‑tenant cloud platform while keeping resource usage efficient.
Zero‑Config TLS
Caddy automatically provisions valid HTTPS certificates for every domain and preview, removing the need for manual SSL management.
Built‑In Observability
Loki + Promtail collect logs, while Grafana provides ready‑made dashboards and health alerts that can be routed to GitHub Issues for instant visibility.
Three‑Step Workflow to Production
-
Bootstrap the Server – Run a single script on a fresh Debian 12 VM. The script installs Docker, PostgreSQL, Redis, Caddy, and the observability stack (Grafana, Loki, Promtail). Example:
sudo bash bootstrap-server.sh -
Create an App from the Template – Use the official
towlion/app-templaterepository. It comes pre‑configured with FastAPI, Alembic migrations, Dockerfile, and GitHub Actions CI/CD.gh repo create my-app --template towlion/app-template -
Push and Deploy – Add four GitHub secrets (Docker Hub credentials, PostgreSQL URL, Redis URL, MinIO access) and push to
main. GitHub Actions builds the Docker image, runs migrations, and updates Caddy with the new sub‑domain.git push origin main
Underlying Technology Stack (Boring Tools Done Right)
| Component | Purpose |
|---|---|
| Docker | Container isolation for each app |
| GitHub Actions | CI/CD pipeline, preview environments |
| Caddy | Reverse proxy + automatic TLS |
| PostgreSQL | Relational data store, schema per app |
| Redis | Cache and pub/sub messaging |
| MinIO (S3 compatible) | Object storage for static assets |
| Grafana + Loki | Metrics, logs, and alerting dashboards |
| FastAPI / Next.js | Backend and frontend frameworks supported out‑of‑the‑box |
Step‑by‑Step Deployment Guide
1. Prepare Your Debian Server
Ensure you have a clean Debian 12 installation with a non‑root user that has sudo privileges. Open ports 80, 443, and 22 (or your preferred SSH port).
2. Run the Bootstrap Script
Download and execute the script:
curl -O https://raw.githubusercontent.com/towlion/micro-paas/main/bootstrap-server.sh
sudo bash bootstrap-server.sh
The script will:
- Install Docker Engine and Docker Compose.
- Set up PostgreSQL, Redis, and MinIO with default credentials (replace them immediately).
- Deploy Caddy with a default configuration that forwards
*.example.comto the appropriate container. - Spin up Grafana, Loki, and Promtail for observability.
3. Fork the App Template
From your GitHub account, click “Use this template” on the Towlion app template. Name the repository my‑awesome‑app.
4. Configure Secrets
Navigate to Settings → Secrets → Actions in your new repo and add:
DOCKER_USERNAME/DOCKER_PASSWORD– for pushing images.POSTGRES_URL– e.g.,postgresql://user:pass@localhost:5432/myapp.REDIS_URL– e.g.,redis://:pass@localhost:6379/0.MINIO_ACCESS_KEY/MINIO_SECRET_KEY.
5. Deploy with a Single Push
Commit any changes and push to main. The GitHub Actions workflow will:
- Build the Docker image.
- Run Alembic migrations against the PostgreSQL instance.
- Update Caddy’s configuration to expose
my‑awesome‑app.example.com. - Notify Grafana of the new service for metrics collection.
Within minutes, your app is live with a valid HTTPS certificate.
How TowlionMicro‑PaaS Stands Next to UBOS Solutions
Both platforms champion self‑hosted, low‑code deployment, yet they target slightly different audiences. While Towlion focuses on a pure Git‑first micro‑PaaS for developers who love the command line, UBOS platform overview offers a broader no‑code/low‑code experience with drag‑and‑drop app builders, AI‑powered marketing agents, and a marketplace of ready‑made templates.
If you need a quick proof‑of‑concept with minimal UI overhead, Towlion’s approach shines. For enterprises that want integrated AI agents, workflow automation, and a visual Workflow automation studio, UBOS may be the better fit.
Extending Your Micro‑PaaS with UBOS Templates
Once your core service is running on Towlion, you can enrich it with AI‑driven features from the UBOS Template Marketplace. For example:
- AI SEO Analyzer – automatically audit your app’s SEO health.
- AI Chatbot template – embed a conversational assistant without writing any backend code.
- AI Video Generator – create marketing videos from text prompts.
- AI Image Generator – produce custom graphics on the fly.
- AI Email Marketing – automate personalized email campaigns.
These templates integrate via the Web app editor on UBOS, allowing you to attach new micro‑services to your existing domain without touching the underlying Docker stack.
Cost, Support, and Community
TowlionMicro‑PaaS is open‑source and free to run on any infrastructure you own. Your primary costs are the underlying VM, storage, and optional third‑party services (e.g., Docker Hub private registries). In contrast, UBOS pricing plans provide tiered SaaS options with managed hosting, premium support, and SLA guarantees.
Both ecosystems have active GitHub communities. For troubleshooting Towlion, consult the official documentation site. For UBOS, the About UBOS page outlines the company’s mission and support channels.
Real‑World Use Cases
Developers have leveraged TowlionMicro‑PaaS for:
- Launching MVPs for SaaS startups (UBOS for startups provides a complementary marketing stack).
- Running internal tools for SMBs (UBOS solutions for SMBs can be layered on top for CRM and analytics).
- Creating sandbox environments for AI research, where each experiment gets its own isolated container and database.
Conclusion: Choose the Right PaaS for Your Vision
If you value full control, a Git‑first workflow, and zero‑cost licensing, TowlionMicro‑PaaS delivers a battle‑tested, production‑ready micro‑PaaS in under ten minutes. Pair it with UBOS’s AI‑centric templates when you need to accelerate marketing, content generation, or customer support without building those capabilities from scratch.
Ready to get started? Visit the UBOS homepage for a broader AI platform perspective, or dive straight into the Towlion documentation to bootstrap your own server today.
Explore more AI‑powered tools that complement a micro‑PaaS environment: