App Platform

Connect a git repository and AhuraSense builds it, runs it and serves it over HTTPS. Every push to your production branch deploys; every other branch gets its own preview.

How it works#

You connect a repository once. From then on a push is the deploy: we fetch the commit, detect the framework, build it into a container image on an isolated build machine, start it, and route your app’s address to it. If the build fails, nothing changes — the previous version keeps serving and the deployment is marked failed with the reason.

Each app gets an address of the form https://v2-<app-name>.ahurasense.com straight away, with a certificate. You can add your own domains alongside it.

Deploy your first app#

  1. Open Apps in the dashboard and connect GitHub, GitLab or Bitbucket. This happens once, in the provider’s own consent screen.
  2. Choose New app, pick a repository and branch, and create it. The first deployment starts immediately.
  3. If the app needs environment variables to build or run, add them under Environment, then deploy again. See Environment variables.
  4. Push a commit. It builds and goes live on its own.
deploy
git push origin main

Ways to integrate#

There are four ways to start a deployment. All of them produce the same kind of deployment, with the same build, logs and rollback.

HowDeploysUse it for
git pushThe pushed branch: production for your production branch, a preview for any otherEveryday development. On by default for every connected repository.
Deploy hookYour production branchDeploying from CI after tests pass, from a CMS, or on a schedule. A secret URL; no key or session needed.
Deploy buttonYour production branchRedeploying by hand from the dashboard.
The APIYour production branchDriving the platform from your own code with an API key: create an app, set variables, deploy, read logs, roll back. See the API reference.

Creating an app is an API call too, so a whole environment can be stood up from a script. An API key acts as the person who created it and can do exactly what they can do in the dashboard — no more.

Two steps always happen outside any API, here and on every similar platform: connecting your git account, which runs through the provider’s own consent screen, and adding DNS records for a custom domain, which you do wherever your domain’s DNS is hosted.

Next#

Something missing or wrong on this page? Tell us, and quote the page title.