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.comemail. Tell Syahman your GitHub username. - An invite to the
superbonfire-laborganisation, 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
- Open https://github.com/signup. Do not use the login page.
- Enter your
@superbonfire.comemail and create a password. - Enter the code that GitHub sends to your email. You need this code only to finish signing up.
- From then on, log in at https://github.com/login with your password.
- Tell Syahman your GitHub username.
Vaultwarden
- Open https://pass.superbonfire.tech/#/signup.
- Enter your
@superbonfire.comemail and create a master password. Keep it somewhere safe. Nobody can reset it for you. - From then on, log in at https://pass.superbonfire.tech with your master password.
- 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 -eIf 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 --versionGit 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 CRLFwarnings are harmless. - If
gitworks 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 githubLinux (Ubuntu/Debian)
sudo apt update
sudo apt install -y gitFor 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 statusIn 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 20Learn the basics
If a step is unclear, learn the basics of that topic first. These resources are free:
- Git crash course: https://www.youtube.com/watch?v=vA5TTz6BXhY
- Git in 100 seconds: https://www.youtube.com/watch?v=hwP7WQkmECE
- Git and GitHub for beginners: https://www.freecodecamp.org/news/git-and-github-crash-course-for-beginners/
- Pull requests in 100 seconds: https://www.youtube.com/watch?v=8lGpZkjnkt4
- About pull requests: https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests
- Conventional Commits: https://www.conventionalcommits.org
- Docker in 100 seconds: https://www.youtube.com/watch?v=Gjnup-PuquQ
- Coolify docs: https://coolify.io/docs