Deploy from GitHub

Connect GitHub#

Under Settings → GitHub, install the Zefily GitHub App on your account or organization and choose the repositories it may read.

Set up a site#

Open the site, go to Deploy, pick the repository and branch, and set the build and release steps (for example composer install --no-dev and php artisan migrate --force). Turn on push to deploy to release on every push to the branch.

How a release goes live#

1. The code is fetched into a new release directory.
2. Build steps run as the site user.
3. Shared files and directories (such as .env and storage) are linked in.
4. The site switches to the new release, and a health check confirms it answers.
5. If the health check fails, the site switches back automatically.

Older releases are kept, so rolling back is instant: pick a release and roll back.

Environment variables#

Secrets are encrypted at rest and sent to the server sealed for that server only. They are never shown in logs.