Docs / Apps

Deploy from GitHub

5 minute read

Connect a GitHub repository and SimpliCloud builds it, runs it and serves it over HTTPS at <name>.apps.simplicloud.ai. No servers to look after.

1. Connect GitHub

Click Create → App and choose GitHub. The first time, GitHub asks you to install the SimpliCloud app on your account or organisation. You can give it access to every repository or only some.

2. Pick a repository and size

Choose the repository and branch, give the app a name and pick a size. The name becomes your URL.

Size	Monthly
Basic	₦7,300
Professional	₦21,900
Pro Plus	₦29,200

3. Create the app

Click Deploy, or create the app from code:

simplicloud apps create storefront \
  --repo kora/storefront --branch main --plan basic
✓ storefront is live
  https://storefront.apps.simplicloud.ai

4. Watch the build

The Deployments tab shows the build log as it runs. SimpliCloud clones the branch, detects the framework, installs dependencies, builds an image, starts it and waits for it to answer on its port.

Build log

==> Cloning https://github.com/kora/storefront.git (branch main)
==> Detected Next.js (package.json)
==> Installing dependencies · 412 packages in 5.1 s
==> Building image
==> Starting the new version and waiting for it to answer on port 3000
==> Health check passed in 3.2 s
==> Live

If a build fails, the previous version keeps serving traffic. Nothing is replaced until the new version passes its health check.

5. Open the app

Your app is live at https://storefront.apps.simplicloud.ai with a certificate already issued. From here, add environment variables, turn on deploy on push or add your own domain.

Was this page helpful?