๐ ๏ธ A platform as a service (PaaS) hosting for Stremio addons: as easy as Heroku/Now.sh, but DYI and without the restrictions.
It is based on Dokku, but with two significant differences:
- It's designed with public use in mind - you can authenticate yourself using your GitHub account and push addons
- It only supports Stremio addons and it's optimized for them (by using specific caching policies)
To deploy this yourself, you'll need:
- A Cherryservers account and API key
- Terraform - tested with version 1.9.x
- Ansible - tested with ansible community package 7.7
- A domain name
- A CloudFlare account and API token
WARNING: this only refers to deploying stremio-beamup itself, not deploying addons to it
-
Run
ssh-keygen -t ed25519 -f id_deploy
orssh-keygen -t ed25519 -f id_deploy -C "tf_deploy_key"
. -
Register on Cherryservers, fund your account and create a project.
-
Paste your numeric project ID into
creds/cherryservers_project_id
; create an API key and paste it into a new file:creds/cherryservers
. -
Start an ssh-agent e.g.
eval `ssh-agent`
& load the key from step 1 into the agent -ssh-add id_deploy
. -
Create an 'authorized_keys' containing the public keys of users who should access the deployment, including the public SSH Key generated in previous step.
-
Run
touch id_ed25519_deployer_sync.pub
to workaround a TF0.12 issue. -
Register a domain.
This can be done in CloudFlare too in the next step, or it can be registered from any domain provider like NameCheap, GoDaddy, etc. -
Setup CloudFlare
- Create an account on CloudFlare.
- Follow the on-screen instructions to add your domain (also known as a 'zone' or 'site').
- Once the zone is added, locate and note down the Zone ID. Add this to a
cloudflare_zone_id
file in thecreds/
directory. - Create an API Token within CloudFlare with the permission of DNS:Edit for the zone you just created. Save this token to a
cloudflare_token
file in thecreds/
directory.
-
Setup Terraform and apply configurations:
- Run the Terraform initialization command:
terraform init
- Apply the Terraform configuration using the appropriate
.tfvars
file for your environment:terraform apply -var-file=dev.tfvars # OR for production terraform apply -var-file=prod.tfvars # for production with more debug logs TF_LOG=DEBUG TF_LOG_PATH="./logs/terraform.log" terraform apply -var-file=prod.tfvars
Make sure to copy and edit the
.tfvars
files from their corresponding.tfvars.example
if you haven't done so. Fill in the necessary information for your specific environment (eitherdevelopment
,production
or other). - Run the Terraform initialization command:
-
Create a DNS A Record for the deployer's public IP, e.g.:
deployer.beamup.dev
.
It can be created in CloudFlare. This DNS can be used withbeamup-cli
to deploy the addons.
By default, this will bootstrap a single server called deployer
that can be used to deploy addons and a docker swarm with three nodes where the addons will be deployed.
CAVEAT: Depending on the Cherryservers node setup, the first ansible playbook execution might fail with "E: Could not get lock /var/lib/dpkg/lock - open (11: Resource temporarily unavailable"
error. This is due to server setup scripts on the Cherryservers, simply restart the terraform apply
command.
Use beamup-cli to deploy addons.
Setting/getting environment variables is similar to the way Dokku does it, however you do it through ssh, and you need to pass the same addon slug that's used in the git remote that ./cli/beamup
adds.
For example: ssh [email protected] config:set 768c7b2546f2/hello NODE_ENV=production
Logs of deployed addons can easily be fetched in way, similar to the way Dokku does it, however through ssh
For example: ssh [email protected] logs 768c7b2546f2/hello
- Why Dokku: it supports both Heroku buildpacks and Docker images, and it's super easy to configure and use
- Why we're using container ports rather than container IPs: so we can make use of the swarm routing for zero downtime
Because they have a Terraform provider and you can pay with Bitcoin.
No - it performs addon-specific checks/optimizations. You can easily modify it for general-purpose usage though, by tweaking NGINX configs and Dokku CHECKS.
No, it supports every stack that there's a heroku buildpack for, as well as any repo that has a Dockerfile
.