Additional notes

Signed-off-by: Alex Ellis (OpenFaaS Ltd) <[email protected]>

Author: alexellis

docs/install-agent.md

@@ -21,38 +21,47 @@ Make sure you've read the [Actuated EULA](https://github.com/self-actuated/actua
 
 If you missed it in the "Provision a Server" page, we recommend you use Ubuntu 22.04 as the host operating system on your Server.
 
-## Coming soon: Auto Enrollment
+## Auto Enrollment
 
-We're working on a feature to make setup quicker and easier:
+!!! info "New! Automated agent installation in preview"
 
-* No need to reach out to us about new servers - they enroll themselves via API
-* No more DNS records to manage, or Let's Encrypt
-* Fully automated setup with a single bash script - for userdata, cloud-init, or manual installs via SSH
+    As of Oct 2023, there's a new and automated onboarding experience for Actuated's Agent.
 
-You'll need to obtain an enrollment token from us to use this feature.
+    This is a significant improvement over the previous manual installation process, making it easier and faster to get started with Actuated.
 
-Example to paste into userdata (or manually via SSH):
+    We're running the Auto Enrollment in parallel with the manual process (see next section) while we gather feedback from users.
+
+You'll need to obtain an *Account API Token* to install your agents using this approach.
+
+Enter the following into cloud-init/userdata or run it manually on the server after connecting with SSH:
 
 ```bash
 #!/bin/bash
 
 curl -LSsf https://get.actuated.com | LICENSE="" \
   TOKEN="" \
-  DOCKER_USERNAME="" \
-  DOCKER_PASSWORD="" \
   HOME="/root" bash -
 ```
 
-* `TOKEN` - this is an API token for the enrollment service - reach out and we'll generate this for you
-* `LICENSE` - the key you purchased for actuated
-* `DOCKER_USERNAME` and `DOCKER_PASSWORD` - your Docker Hub credentials for the pull-through cache. [Create a token here](https://docs.docker.com/security/access-tokens/) or leave empty to cache layers pulled anonymously.
-* `HOME` - the home directory of the user running the script - this is required during userdata since HOME is usually an unset variable.
+Minimum configuration:
 
-The installation will guess the best place to store VM snapshots, and if a space disk or partition is found, it will be wiped and formatted.
+* `TOKEN` - your Account API Token - reach out to us and we'll generate one for you
+* `LICENSE` - the key you received when you [purchased an actuated subscription](https://actuated.com/pricing)
+cache layers pulled anonymously
+* `HOME` - Set this only if using cloud-init/userdata - where HOME is usually unset. Otherwise leave it blank and the script will use the current user's home directory.
+
+Additional configuration:
 
-If the script doesn't find any valid storage, it will provision a loopback file instead which is fine for basic testing. You can specify a specific disk or partition by setting the `VM_DEV` environment variable.
+* `DOCKER_USERNAME` and `DOCKER_PASSWORD` - your Docker Hub credentials for the pull-through cache. [Create a token here](https://docs.docker.com/security/access-tokens/) or leave empty to 
+* `LABELS` - apply a comma-separated list of labels to the agent, e.g. `gce` or `gce,ssd`
+
+Storage configuration:
+
+* `VM_DEV` - a disk or partition to use for VM storage - leave blank for to autodetect a spare disk. If no disk is found, a loopback file will be used.
+
+The installation will guess the best place to store VM snapshots, and if a space disk or partition is found, it will be wiped and formatted.
 
-## Install the Actuated Agent
+## Manual Enrollment
 
 !!! info "Do you want a free, expert installation?"
 

docs/provision-server.md

@@ -32,7 +32,7 @@ For the absolute best value in terms of performance and cost, we recommend the f
 * *x86_64* - [Hetzner's A102](https://www.hetzner.com/dedicated-rootserver/ax102)
 * *Arm64* - [Hetzner's RX170](https://www.hetzner.com/dedicated-rootserver/matrix-rx)
 
-Servers on Hetnzer arrive with a "rescue" system, use it to install Ubuntu 22.04, and make sure you disable software RAID, so that the two NVMe drives are presented as separate devices. One will run the system, the other will be used for filesystems for all the VMs.
+Hetzner machines come with a "rescue" system, use it to install Ubuntu 22.04, and make sure you disable software RAID, so that the two NVMe drives are presented as separate devices. One will run the system, the other will be used for filesystems for all the VMs.
 
 ## Our research on servers for actuated
 
@@ -81,7 +81,11 @@ Intel and AMD CPUs can be used interchangeable and are known as `amd64` or `x86_
 
     This option may not have the raw speed and throughput of a dedicated, bare-metal host, but keeps costs low and is convenient for getting started.
 
-    We know of at least three providers which have options for nested virtualisation: [DigitalOcean](https://m.do.co/c/8d4e75e9886f), [Google Compute Platform (GCP)](https://cloud.google.com/compute) (new customers get 300 USD free credits from GCP) support nested virtualisation on their Virtual Machines (VMs), and [Azure](https://azure.com/).
+    We know of at least three providers which have options for nested virtualisation: [DigitalOcean](https://m.do.co/c/8d4e75e9886f), [Google Compute Platform (GCP)](https://cloud.google.com/compute) (new customers get 300 USD free credits from GCP) support nested virtualisation on their Virtual Machines (VMs), and [Azure](https://azure.com/).'
+
+    Nested Virtualisation is enabled by default on most clouds, however on GCP you will need to enable it via the `--enable-nested-virtualization` flag when creating a VM via `gcloud` CLI or API. This option is not listed in the GCP's web console.
+
+    If your only option is to use AWS EC2 VMs, then we can help you get up and running using Firecracker with KVM backed by Pagetable Isolation, [learn more here](https://blog.alexellis.io/how-to-run-firecracker-without-kvm-on-regular-cloud-vms/). 
 
 3. Bare-metal on-premises (cheap, convenient, high performance)