https://github.com/bwinter/baroboys
Headless Game Server (GCP, Terraform, and more)
https://github.com/bwinter/baroboys
flask packer systemd terraform
Last synced: 4 months ago
JSON representation
Headless Game Server (GCP, Terraform, and more)
- Host: GitHub
- URL: https://github.com/bwinter/baroboys
- Owner: bwinter
- License: other
- Created: 2022-09-27T05:00:50.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2026-02-13T22:33:04.000Z (5 months ago)
- Last Synced: 2026-02-14T04:46:42.298Z (5 months ago)
- Topics: flask, packer, systemd, terraform
- Language: HTML
- Homepage:
- Size: 463 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Game Server and Infrastructure Setup
This project is an attempt at fully automating steam headless servers.
Tech tl;dr is basically: Terraform and Bash.
---
## 🧰 Requirements
- Terraform
```shell
brew tap hashicorp/tap
brew install hashicorp/tap/terraform
```
- Packer
```shell
brew tap hashicorp/tap
brew install hashicorp/tap/packer
```
- Google Cloud SDK (`gcloud`)
```shell
curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-457.0.0-darwin-arm.tar.gz
tar -xvzf google-cloud-cli-457.0.0-darwin-arm.tar.gz
./google-cloud-sdk/install.sh
```
- A valid GCP project (e.g., `europan-world`)
- GitHub account (for deploy keys)
---
## 🚀 Getting Started
1. **Configure GitHub SSH access (once)**
- See [`docs/setup/github-deploy-key.md`](./docs/setup/github-deploy-key.md)
- This ensures your VM can clone private repos
2. **Install GCP tooling** (once)
- See [`docs/setup/installing-gcloud.md`](docs/setup/gcp-service-accounts.md)
3. **Configure GCP tooling** (once)
- See [`docs/setup/gcp-service-account.md`](docs/setup/gcp-service-accounts.md)
- After completion, Makefile should now be usable
4. **Debug server**
- See [`docs/usage/troubleshooting.md`](./docs/usage/troubleshooting.md)
- Some basic commands you can run to debug install and game server issues.
5. **Barotrauma Submarine Development**
- See [`docs/setup/barotrauma.md`](docs/setup/gcp-service-accounts.md)
- Helpful when building submarines.
---
## 🚀 Step-by-Step Setup
### 1. Clone the repo and initialize Terraform
```bash
git clone git@github.com:bwinter/baroboys.git
cd baroboys/terraform
terraform init
```
---
### 2. Set your game mode (optional, default is `vrising`)
```bash
make switch
```
Ensure `direnv` is installed and run (or set env manually):
```bash
direnv allow .
```
---
### 3. Build packer image
```bash
make build
```
* This installs a bunch of dependencies
* GCP monitoring
* Steam, Wine, Xvfb and their dependencies
* Some helpful command line tools. e.g. curl, wget etc
---
### 4. Apply Terraform to create your VM and configure the server
```bash
make apply
```
* This boots a VM
* Updates repos and games
* Clones this repo for both `root` and `bwinter_sc81`
* Installs and configures the selected game
* Registers a `systemd` service for the game
* Registers a shutdown hook to auto-save to Git
---
### 5. Manually trigger a save (anytime)
```bash
make save
```
---
### 6. Destroy the instance when done
```bash
make destroy
```
💡 Auto-save runs before shutdown if the game service exits cleanly.
---
## 🛠️ Debugging
| Goal | Command |
|-------------------|----------------------------------------------------------------------------|
| View startup logs | `gcloud compute instances get-serial-port-output europa --zone=us-west1-c` |
| View systemd logs | `journalctl -u google-startup-scripts.service -e` |
| Debug save | `journalctl -u barotrauma.service -e` or check Git commit logs |
---
## 📦 Developers
- **Documentation** (`/docs`)
- Clear setup and usage instructions
- Covers service accounts, SSH key setup, troubleshooting, and more
- **Terraform Infrastructure** (`/terraform`)
- Provisions VMs, enables GCP APIs, and configures IAM
- **Startup & Deployment Scripts** (`/scripts`)
- Bootstraps Barotrauma environment on VM boot
- Securely pulls GitHub SSH key from Secret Manager
- Runs custom server setup logic
- **Barotrauma State & Mods** (`/Barotrauma`)
- Contains saved games, mod files, and game server config
---
## 🔐 Security Notes
- All secrets (e.g., GitHub deploy key, service account JSON) should be stored locally and excluded from version
control.
## License
This project is licensed under
the [Polyform Small Business License](https://polyformproject.org/licenses/small-business/1.0.0/).
- ✅ Free for personal, educational, and small business use (under $1M revenue)
- ❌ Commercial use by larger companies requires a commercial license
If you’re a business above the size threshold and would like to use this project, please contact me
at [your-email@example.com].