Your own gaming box in the Cloud ! 🎮 ⛅
- Development status 🧪
- Features ✨
- Getting started 🚀
- Usage and configuration
- Supported gaming servers and Cloud providers
- FAQ
- License
This project is still at an experimental phase. While working and allowing you to play in the Cloud seamlessly, there may be breaking changes in the future. Feel free to contribute and provide feedback !
Compatible with Moonlight streaming client
Gaming servers:
Cloud providers:
- AWS
- (available soon) Azure
- (available soon) Google Cloud
Prerequisites:
- A Clouder account (eg. AWS)
- Make sure you understand the costs 💸 of running a gaming instance in the Cloud
Note: installation is very basic for now, requiring to clone Git repo and build app. I'm actively working on npm and other distribution methods (eg. static binary, container image).
Clone this Git repository:
git clone https://github.com/PierreBeucher/Cloudy-Pad.git
cd Cloudy-PadBuild Cloudy Pad cloudypad CLI with either:
🐳 Docker or Podman
Run :
docker compose run cloudypad
podman-compose run cloudypadYou'll be dropped into a shell with ready-to-use cloudypad CLI.
🖥️ Build locally
Make sure to have installed:
- Pulumi 3.x or anterior
- NodeJS 18.x or anterior
- Typescript 5.x or anterior
Run:
npm install
npm run build
npm install -gcloudypad CLI should now be available on path.
Deploy a Wolf server on AWS:
cloudypad deploy examples/gaming/wolf-aws.ymlOnce your instance is deployed and ready, use Moonlight to access it. Get your instance IP or address with (it should be shown after deployment):
cloudypad get examples/gaming/wolf-aws.ymlOnce Moonlight asks for PIN, open browser to PIN validation page with:
cloudypad utils wolf open-pin examples/gaming/wolf-aws.ymlRemember to stop or destroy your instance when done:
cloudypad stop examples/gaming/wolf-aws.ymlStart instance later with:
cloudypad start examples/gaming/wolf-aws.ymlOr destroy instance altogether (all data will be lost):
cloudypad destroy examples/gaming/wolf-aws.ymlCloudy Pad uses YAML configuration to manage your gaming box via CLI. See examples configurations.
Basic commands:
# Show help
cloudypad --help
# Deploy a Box (provision + configure)
cloudypad deploy examples/gaming/wolf-aws.yml
# Provision a Box
# Only run infrastructure provisioning
# such as AWS resource management
cloudypad provision examples/gaming/wolf-aws.yml
# Configure a Box
# Only run Box configuration (NixOS rebuild)
cloudypad configure examples/gaming/wolf-aws.yml
# Get a Box details
cloudypad get examples/gaming/wolf-aws.yml
# Destroy a Box
cloudypad destroy examples/gaming/wolf-aws.ymlDefault configuration per provider:
- AWS:
g5.xlargeinstance (16Gb RAM, 4 CPU, NVIDIA A10G Tensor Core), 150Go Disk, dynamic IP allocation - Azure (available soon): 150Go Disk, dynamic IP allocation, instance type to be specified
- GCP (available soon): 150Go Disk, dynamic IP allocation, instance type to be specified
Boxes are customizable to specify instance types, disk size, DNS record, IP configuration and more ! (See below)
A box configuration is a YAML file looking like this:
# Unique name for your Box
name: cloud-gaming-gear
# The box Kind
# Only gaming.Wolf is supported for now, but more will come gaming.Sunshine
kind: gaming.Wolf
# Box specifications
# A few technical details to know where and how to deploy your Box
spec:
ssh:
authorizedKeys:
- ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIGaNlYLbwtAmfcNjlOsP6Ryh3QxGn9qlhlQjPo5nbzBa
provisioner:
aws: {}Get your box details with:
cloudypad get examples/gaming/wolf-aws.yml
# Output something like
Then use ssh:
ssh root@<address>Specify authorized SSH keys:
spec:
ssh:
authorizedKeys:
- ssh-ed25519 AAA123...
- ssh-ed25519 AAA456...SSH keys will be added on next Box configuration.
Note: you must own an Hosted Zone on the cloud Provider and have it configured accordingly. See provider doc for details.
spec:
dns:
zoneName: gaming.crafteo.ioWill create a DNS A record pointing to your instance.
You can set detailed configuration:
spec:
dns:
zoneName: gaming.crafteo.io
# Will create record mybox.gaming.crafteo.io
# instead of record at root on gaming.crafteo.io
prefix: mybox
# DNS Record Time-To-Live in seconds
# Default to 60
ttl: 3600For now only AWS is supported, more will come soon !
Set aws provisioner in your Box config:
spec:
provisioner:
aws: {}You can also override the underlying provisioner config:
spec:
provisioner:
aws:
# Set AWS region and other configs
config:
region: eu-central-1
# Set instance details
instance:
staticIpEnable: true,
rootVolume:
sizeGb: 500
type: g5.2xlargeSet azure provisioner in your Box config:
spec:
provisioner:
azure: {}Set gcp provisioner in your Box config:
spec:
provisioner:
gcp: {}Indeed, AWS/GCP/Azure are expensive for a gaming box.
This project aim to support cheaper Cloud providers like Paperspace or TensorDock (if you're curious you can find an experimental Paperspace box hidden in the code, though it's not fully working yet). Do not to hesitate to contribute or ⭐ the project, it will help move things forward !
Wolf is an open source streaming server for Moonlight that allows you to share a single server with multiple remote clients in order to play videogames. It works via containers to provide various services such as Steam Big Picture.
Sunshine is a self-hosted game stream host for Moonlight. You can install anything on your instance (eg. Steam or other) and stream it with Moonlight.
This project intend to support Parsec. Feel free to propose other gaming servers !
Cloudy-Pad is free and open-source, however charges may apply when using a Cloud provider. Here's an estimation for AWS:
| Gaming time / month | 15h | 20h | 20h | 30h |
|---|---|---|---|---|
| EC2 instance type | g5.xlarge | g5.xlarge | g5.2xlarge | g5.2xlarge |
| Disk size (gp3 SSD) | 100 Go | 100 Go | 100 Go | 100 Go |
| EC2 instance $ | $18.87 | $25.16 | $30.31 | $45.47 |
| Route53 record $ | $0.00 | $0.00 | $0.00 | $0.00 |
| EC2 volume (disk) $ | $9.52 | $9.52 | $9.52 | $9.52 |
| EIP address $ | (no eip) | $3.50 | (no eip) | $3.45 |
| Est. TOTAL / month $ | ~$28 | ~$38 | ~$40 | ~$58 |
*Estimation based on eu-central-1 (Frankfurt) pricing in December 2023. Exact prices vary with time and regions.
This project's goal is to provide 20h / month for 20$ - Paperspace and TensorDock are good bets, but not ready to use yet.
Equivalent estimation for other providers will be added as they become ready.
Deployment is divided in two phases:
- Provisioning: manage Cloud resources (virtual machines, firewall, volumes disks, etc.)
- Currently managed via Pulumi
- Configuration: install everything on instance (gaming server, GPU drivers, etc.)
- Currently managed via NixOS
A small framework, Cloudy Box, allow seamless integration of both technologies.
Yes ! Underlying Cloudy Box framework is actually designed for that: easy deployment of Cloud infrastructure with NixOS (or other configuration tools). In the future it will be merged-out of this project to become a more generic Cloudy Box CLI and/or API project which Cloudy Pad will use.
If you're interested in these features, do not hesitate to reach me directly - my email can be found easily on my website crafteo.io.
Probably not in it's current form. Considering I'm really not happy about the enshittification of the internet, Cloudy Pad will remain FOSS - at least for personal use.
However, the larger Cloudy Box scope may become a paid product for professional use cases, not necessarily linked to gaming.