diff --git a/assets/icons/cloud-bolt-solid-full.svg b/assets/icons/cloud-bolt-solid-full.svg new file mode 100644 index 0000000..af7e067 --- /dev/null +++ b/assets/icons/cloud-bolt-solid-full.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/assets/icons/cloud-solid-full.svg b/assets/icons/cloud-solid-full.svg new file mode 100644 index 0000000..5e1ee0b --- /dev/null +++ b/assets/icons/cloud-solid-full.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/content/get-started/_index.md b/content/get-started/_index.md new file mode 100644 index 0000000..d0f66f3 --- /dev/null +++ b/content/get-started/_index.md @@ -0,0 +1,34 @@ +--- +title: 🌩️ Get started +date: 2025-08-06 +layout: single +series: + - Wild Cloud Setup +series_order: 1 +--- + +You've decided to see what is involved in this 🌩️ "Wild Cloud" thing. Welcome! + +What follows is a step-by-step setup guide for early adopters. We'll do our best to keep these instructions in sync with the latest Wild Cloud software. + +## 🚧 Under Construction 🚧 + +First of all, Wild Cloud is in active development as are these pages. We prefer to develop things "in the open" since this is a community project. Feel free to try things out now (we have two pilot clouds running), but expect some bumps** until we get everything sorted and remove this notice. + +## Take your time! + +One of our big objective with Wild Cloud is to make Internet technology more accessible to everyone. We want setting up and maintaining your wild cloud to be a fun learning experience, so you'll find that we interject {{< icon "circle-info" "#05df72" >}} definitions, and let you {{< icon "graduation-cap" "#5d0ec0" >}} go deeper with tips or entire articles, but we always bring things {{< icon "sun" "#fff085" >}} back around to your own wild cloud where you can try things out first-hand. + + +All of the technology we use in Wild Cloud is open source and widely used, so investing time to really learn the concepts in this setup guide will be well spent. + +## The path ahead + +The following pages will guide you through buying your wild cloud hardware, setting up each of the various components, and, in the end, deploying applications and managing your wild cloud. + + +
+ {{< button href="hardware" target="_self" >}} + Let's begin! + {{< /button >}} +
\ No newline at end of file diff --git a/content/get-started/dns-server-setup/index.md b/content/get-started/dns-server-setup/index.md index eaf2cc6..bf136c4 100644 --- a/content/get-started/dns-server-setup/index.md +++ b/content/get-started/dns-server-setup/index.md @@ -1,8 +1,10 @@ -+++ -title = "Setup Wild Cloud" -date = '2025-06-09' -draft = false -+++ +--- +title: Set up your DNS server +date: 2025-08-04 +series: + - Wild Cloud Setup +series_order: 5 +--- ## Get your hardware @@ -23,3 +25,7 @@ Make sure you have a dedicated machine for your DNS server. It can be tiny, like - Log in to your LAN router's web interface. - Find the DHCP settings and reserve the IP address you recorded for your DNS server. - Set the DNS server for your LAN to the IP address of your DNS server. + +## Next Steps + +Now that you have a DNS server set up, let's [set up your wild cloud](../setup-wild-cloud/). diff --git a/content/get-started/get-a-domain-name/index.md b/content/get-started/get-a-domain-name/index.md index 776a97b..5866e84 100644 --- a/content/get-started/get-a-domain-name/index.md +++ b/content/get-started/get-a-domain-name/index.md @@ -1,8 +1,10 @@ -+++ -title = "Get a Domain Name" -date = '2025-06-09' -draft = false -+++ +--- +title: Get a Domain Name +date: 2025-08-02 +series: + - Wild Cloud Setup +series_order: 3 +--- ## Get a Domain Name @@ -16,3 +18,8 @@ Instructions... ## Set up your LAN router - DynamicDNS + + +## Next Steps + +Now that you have a domain name, let's [set up your operator machine](../operator-setup/). diff --git a/content/get-started/hardware/index.md b/content/get-started/hardware/index.md index 824e46a..05a7fec 100644 --- a/content/get-started/hardware/index.md +++ b/content/get-started/hardware/index.md @@ -1,8 +1,10 @@ -+++ -title = "Hardware" -date = '2025-06-09' -draft = false -+++ +--- +title: Hardware +date: 2025-08-01 +series: + - Wild Cloud Setup +series_order: 2 +--- ## Get your hardware @@ -10,9 +12,9 @@ A basic wild cloud requires 8 computers, a network switch, a battery backup, and Six of the computers run Talos Linux and are your "cluster nodes". One computer will run your local network's name server so you can access internal cloud applications. The last computer is just used to manage your cluster. Most of these computers can be small or old machines, and they are all managed by Wild Cloud, so don't think it's too expensive or complicated to get started. A really useful wild cloud can be built for less than the price of a new smart phone. -{{}} +{{}} In computing, the word "machine" goes back to Alan Turing’s 1936 concept of the ‘Turing machine,’ and to early electromechanical computers like ENIAC that were literally giant calculating machines. Today, in Kubernetes and cloud systems, like your wild cloud, we still use the word "machine" to mean any physical or virtual computer that runs workloads. -{{}} +{{}} ## Your "operator" machine @@ -70,4 +72,4 @@ USB thumb-drives are useful for booting your wild cloud machines and for transfe ## Next Steps -Now that you have your hardware, we can start setting things up! Follow the instructions in the [Setup Wild Cloud](../setup-wild-cloud/) guide to get started. +Now that you have your hardware, let's make sure you've [acquired a domain name](../get-a-domain-name/) guide to get started. diff --git a/content/get-started/index.md b/content/get-started/index.md deleted file mode 100644 index ce340a3..0000000 --- a/content/get-started/index.md +++ /dev/null @@ -1,15 +0,0 @@ -+++ -title = "Get Started" -date = '2025-06-09' -draft = false -+++ - -_The Wild Cloud project is in active development._ - -1. [Get your hardware](./hardware/) -2. [Reserve a domain name](./get-a-domain-name/) -3. [Set up your operator machine](./operator-setup/) -4. [Set up your DNS server](./dns-server-setup/) -5. [Set up your Wild Cloud](./setup-wild-cloud/) -6. [Use your Wild Cloud](./using-wild-cloud/) - diff --git a/content/get-started/operator-setup/index.md b/content/get-started/operator-setup/index.md index 826c48c..7f2a82e 100644 --- a/content/get-started/operator-setup/index.md +++ b/content/get-started/operator-setup/index.md @@ -1,18 +1,20 @@ -+++ -title = "Operator Setup" -date = '2025-06-09' -draft = false -+++ - -The Wild Cloud software is Open Source and free. All you need to do is download it onto your operator machine, install some other programs we require, and then run the setup script. The setup script walks you through the process of installing your DNS machine, your control nodes, your worker nodes, and then any software you want to run on your cloud. +--- +title: Operator machine +date: 2025-08-03 +series: + - Wild Cloud Setup +series_order: 4 +--- (This page assumes you already have your hardware ready to set up. If you don't, read [Setting Up Your Hardware](../hardware/)). +## Your operator machine + +Your operator machine is your main workspace (I think of it more as play, actually) for managing your wild cloud. You will install the Wild Cloud software on your operator machine and use it to setup and manage everything related to your wild cloud. ## Download the Wild Cloud software onto your operator machine - -Your operator machine should be a Debian-based Linux machine (e.g. Debian or Ubuntu) on your LAN. It's helpful if it has a nice big hard drive you can use for backing up your cloud data. +Your operator machine should be a [Linux](/learning/linux/) machine on your LAN. It's helpful if it has a nice big hard drive you can use for backing up your cloud data. {{< gitea server="https://git.civilsociety.dev" repo="CSTF/wild-cloud" showThumbnail=true >}} diff --git a/content/get-started/setup-wild-cloud/index.md b/content/get-started/setup-wild-cloud/index.md index bde8d9b..4499ba6 100644 --- a/content/get-started/setup-wild-cloud/index.md +++ b/content/get-started/setup-wild-cloud/index.md @@ -1,9 +1,10 @@ -+++ -title = "Setup Wild Cloud" -date = '2025-06-09' -draft = false -+++ - +--- +title: Set up your wild cloud +date: 2025-08-05 +series: + - Wild Cloud Setup +series_order: 6 +--- ## Set up your own Wild Cloud! diff --git a/content/get-started/using-wild-cloud/index.md b/content/get-started/using-wild-cloud/index.md index 5ea88ea..33057a9 100644 --- a/content/get-started/using-wild-cloud/index.md +++ b/content/get-started/using-wild-cloud/index.md @@ -1,8 +1,10 @@ -+++ -title = "Use Your Wild Cloud" -date = '2025-06-09' -draft = false -+++ +--- +title: Use your wild cloud +date: 2025-08-06 +series: + - Wild Cloud Setup +series_order: 7 +--- ## Installing Applications diff --git a/static/papers/cerf74.pdf b/static/papers/cerf74.pdf new file mode 100644 index 0000000..8923d97 Binary files /dev/null and b/static/papers/cerf74.pdf differ diff --git a/static/papers/rfc882.txt.pdf b/static/papers/rfc882.txt.pdf new file mode 100644 index 0000000..dba19d7 Binary files /dev/null and b/static/papers/rfc882.txt.pdf differ