SBF Innovation Lab Wiki
Deployment

Setup

Accounts and tools you need before you deploy

Access checklist

Confirm each item before you start. If something is missing, ask Syahman.

  • A GitHub account with your @superbonfire.com email. Tell Syahman your GitHub username.
  • An invite to the superbonfire-lab organisation, with Write access to the repositories you need.
  • A Coolify account with the Member role. Syahman sends the invite.
  • An invite to the Cloudflare account, if you need to manage DNS for subdomains.
  • A Vaultwarden account. All shared secrets live there.
  • Git and GitHub CLI on your computer.
  • Optional: an SBF ID account for passkey login. See Sign in.

SSH access to the VPS is not granted for now. Do not try to SSH into the server.

Sign up first, then log in

Signing up and logging in are different steps. Create the account first.

GitHub

  1. Open https://github.com/signup. Do not use the login page.
  2. Enter your @superbonfire.com email and create a password.
  3. Enter the code that GitHub sends to your email. You need this code only to finish signing up.
  4. From then on, log in at https://github.com/login with your password.
  5. Tell Syahman your GitHub username.

Vaultwarden

  1. Open https://pass.superbonfire.tech/#/signup.
  2. Enter your @superbonfire.com email and create a master password. Keep it somewhere safe. Nobody can reset it for you.
  3. From then on, log in at https://pass.superbonfire.tech with your master password.
  4. Tell Syahman, so he can add you to the organisation.

Common mistake

Do not enter your email on the login page and wait for a code. You log in with your password. Email codes are only for signing up.

Install the tools

You need Git. GitHub CLI (gh) is recommended. GitHub Desktop is an optional visual app.

Windows

Use PowerShell:

winget install --id Git.Git -e
winget install --id GitHub.cli -e
# Optional:
winget install --id GitHub.GitHubDesktop -e

If winget is not found, install Git from https://git-scm.com/download/win and GitHub CLI from https://cli.github.com.

Restart the terminal, then check:

git --version
gh --version

Git for Windows installs Git Bash. All bash examples in this wiki run in Git Bash.

  • Keep the default line-ending option in the Git installer. LF will be replaced by CRLF warnings are harmless.
  • If git works in Git Bash but not in PowerShell, restart PowerShell. Its PATH may not be updated yet.

macOS

# Install Homebrew first: https://brew.sh
brew install git gh
# Optional:
brew install --cask github

Linux (Ubuntu/Debian)

sudo apt update
sudo apt install -y git

For gh, follow https://github.com/cli/cli/blob/trunk/docs/install_linux.md.

Configure Git

git config --global user.name "Your Name"
git config --global user.email "you@superbonfire.com"

Sign in to GitHub

gh auth login
# GitHub.com → HTTPS → Login with a web browser
gh auth status

In GitHub Desktop, choose Sign in to GitHub.com and finish in the browser.

Check that you can see the organisation:

gh repo list superbonfire-lab --limit 20

Learn the basics

If a step is unclear, learn the basics of that topic first. These resources are free:

On this page