Skip to content

The lightweight and easy way to deploy static websites, web apps, backends, IoT projects, and any other web projects without any vendor lock-in, straight from your local directory. No Git required, no wasting time on configuration, no setup, zero dependencies - just run one command

License

Notifications You must be signed in to change notification settings

localcloud-dev/turbo-cloud

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 

Repository files navigation

TurboCloud: The Lightweight and Easy Way to Deploy Web Projects

TurboCloud is the lightweight and easy way to deploy static websites, web apps, backends, IoT projects, and any other web projects without any vendor lock-in, straight from your local directory. No Git, no wasting time on configuration, no setup - just run one command on your local machine to get your web project online with automatic HTTPS, auto restarting, low resource usage, and almost zero deployment configuration.

Don't forget to click on Star if you like the project.

Advantages

  • Zero dependencies - your project will be available until your cloud provider is live
  • Daemonless
  • Unbelievable lightweight - one script, less than 10KB
  • HTTPS for custom domains
  • Works with WebSocket services (ws:// and wss://)
  • TurboCloud itself uses very small resources
  • Fully predictable cloud costs (with cloud providers from "Recommended Cloud Providers" below)
  • Zero DevOps knowledge required
  • Only one command to deploy from your local machine
  • Works with virtually any cloud provider
  • No Docker registry required
  • Zero downtime deployments

How to Deploy Static Websites

Notes

  • Check the examples/static-website directory to see how TurboCloud handles folders
  • index.html in each folder (including the root folder) will be available at domain.com and domain.com/folder_name
  • Each HTML file is available under two URLs: domain.com/file_name and domain.com/file_name.html
  • We use Static Web Server for containers with static websites

Deployment steps

  1. Order a VPS, cloud server, or dedicated server with a public IP address, fresh Ubuntu 22.04, and SSH access from any cloud provider (see Recommended Cloud Providers section below).
  2. Add an A record with the IP address of your new server to your custom domain (DNS A record: your_domain.com or subdomain.your_domain.com -> IP address of a server created at the step 1)
  3. In the root folder of your static website project, run the following command (replace ip_address_of_server, expose_port_from_dockerfile and your_domain_without_http_https with real values):
curl https://raw.githubusercontent.com/localcloud-dev/turbo-cloud/main/turbocloud | sh -s -- -i ip_address_of_server -d your_domain_without_http_https -t static -p expose_port_from_dockerfile
  1. Open the URL you set with flag -d in step 3 in the browser

How to Deploy projects with Dockerfile

Notes

  • Dockerfile should be in the project's root folder
  • Dockerfile should include EXPOSE SOME_PORT, the same port should be set in -p parameter in the TurboCloud deploy command

Deployment steps

  1. Order a VPS, cloud server, or dedicated server with a public IP address, fresh Ubuntu 22.04, and SSH access from any cloud provider (see Recommended Cloud Providers section below).
  2. Add an A record with the IP address of your new server to your custom domain (DNS A record: your_domain.com or subdomain.your_domain.com -> IP address of a server created at the step 1)
  3. In the root folder of your project with Dockerfile (Dockerfile should be in the project's root folder), run the following command (replace ip_address_of_server and your_domain_without_http_https with real values):
curl https://raw.githubusercontent.com/localcloud-dev/turbo-cloud/main/turbocloud | sh -s -- -i ip_address_of_server -d your_domain_without_http_https -t dockerfile
  1. Open the URL you set with flag -d in step 3 in the browser

Coming Soon

  • Any services and apps with Docker Compose
  • Native support for frontend frameworks (Next.js, Vue.js, Svelte, etc.)

Recommended Cloud Providers

  • DigitalOcean
  • Vultr
  • Scaleway
  • OVH
  • Other cloud providers where you can sign up and spin up an instance without reading tons of docs

Cloud Providers to Avoid

We don't recommend using AWS, Google Cloud, or Azure because:

  • They're overengineered and way too expensive
  • Someone should pay for all their free tiers, startup programs, and marketing costs
  • They have way too many infrastructure layers to deal with
  • They try to lock you in at every step
  • Their support sucks or is non-existent unless you pay for a premium plan
  • The learning curve is insane

Projects used in TurboCloud

License

MIT

About

The lightweight and easy way to deploy static websites, web apps, backends, IoT projects, and any other web projects without any vendor lock-in, straight from your local directory. No Git required, no wasting time on configuration, no setup, zero dependencies - just run one command

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages