Skip to main content

Quick Start

This guide walks you through deploying your first application with Miabi — entirely from the web console, no Docker commands required.

1. Install Miabi​

Follow the Installation guide to bring up the stack, then open your domain and sign in as the platform admin, seeded on first boot from MIABI_ADMIN_EMAIL / MIABI_ADMIN_PASSWORD (the installer generates that password and prints it once).

2. Create a workspace​

Workspaces own every resource and provide multi-tenant isolation. After logging in, create your first workspace (or use your personal space). Everything you deploy lives inside a workspace.

Workspace dashboard

See Workspaces for the full model.

3. Create an application​

From the workspace, click Create application and choose a source:

  • Git repository — Miabi clones and builds your code. See Deploy from Git.
  • Docker image — Miabi pulls an existing image from a registry. See Deploy from Image.
  • Marketplace template — a one-click install of a pre-packaged app. See Marketplace.

Create application dialog

For this walkthrough, pick a Docker image such as nginx:latest — it requires no build and deploys instantly.

4. Configure and deploy​

Set any environment variables and resource limits you need, then click Deploy. Miabi pulls the image, creates the container, and records a release.

Application overview

Watch progress in the application timeline and live logs.

5. Connect a domain and get SSL​

Open the app's Domains tab and add a domain (for example app.example.com). Miabi guides you through DNS verification, then routes traffic through Goma Gateway and issues an SSL certificate automatically via Let's Encrypt.

Domains with verification status

Within a moment your app is reachable at https://app.example.com with a valid certificate.

6. Add a database (optional)​

Need persistence? Provision a managed database — PostgreSQL, MySQL, MariaDB, Redis, MongoDB, or libSQL — from the Databases section. Miabi generates credentials and exposes them to your app.

Databases

See Databases and Backups.

What's next​

You now have a deployed app on your own server with automatic SSL. Explore further: