The cloud, without the cloud

1. Open Terminal — press ⌘+Space, type Terminal, press Return. A window appears where you can type commands — that's all it is.
2. Install Go (one-time) — download the macOS installer from go.dev/dl and run it, like any app.
3. Copy-paste this into Terminal and press Return. git clone creates its own cloudless folder — don't make one yourself first, or you'll end up nested inside an extra empty folder of the same name:

   git clone https://github.com/asifontheline/cloudless
   cd cloudless/cloudless
   go build -o cloudless ./cmd/cloudless
   ./cloudless up

   If your Mac offers to install "command line developer tools" the first time, click Install and re-run the first line.

1. Open PowerShell — press the ⊞ Windows key, type PowerShell, press Enter. A window appears where you can type commands — that's all it is.
2. Make sure you're in a folder you own. PowerShell sometimes opens into C:\Windows\System32 or another system folder you don't have permission to write to — paste this and press Enter to jump to your user folder first:

   cd $HOME

   Every command below assumes you're here. If anything later fails with Permission denied, you're probably back in a system folder — run cd $HOME again and retry.
3. Install the tools (one-time) — paste this and press Enter:

   winget install Git.Git GoLang.Go

4. Close this PowerShell window completely and open a new one. This step is easy to miss but required — Windows only picks up git and go on PATH in a fresh window; typing the next commands in the same window that ran the install will fail with git : The term 'git' is not recognized....
5. In the new window, first cd $HOME again (a fresh window can land somewhere new too), then copy-paste this and press Enter. git clone creates its own cloudless folder — don't make one yourself first, or you'll end up nested inside an extra empty folder of the same name:

   cd $HOME
   git clone https://github.com/asifontheline/cloudless
   cd cloudless\cloudless
   go build -o cloudless.exe ./cmd/cloudless
   .\cloudless.exe up

   Still not recognized after a fresh window? Search Git Bash in the Start menu (installed alongside Git) and run the same commands there instead — it works regardless of PowerShell's PATH.

If cloudless.exe is "blocked by your organization's Device Guard policy" — that message shows even on personal, non-work machines; it's Windows' Smart App Control feature blocking an unsigned binary (release binaries aren't code-signed yet — tracked in #23). Check Windows Security → App & browser control → Smart App Control: if it says Evaluation, you can turn it off there (a restart is required for the change to actually take effect, even though the toggle updates immediately). If it says On, Microsoft does not allow turning it back off without reinstalling Windows — in that case, run cloudless inside WSL instead, which isn't subject to this Windows-executable-specific policy at all:

wsl --install
# after the restart it asks for, open the "Ubuntu" app, then inside it:
sudo apt update && sudo apt install -y golang-go git
git clone https://github.com/asifontheline/cloudless
cd cloudless/cloudless
go build -o cloudless ./cmd/cloudless
./cloudless up

1. Open a terminal — Ctrl+Alt+T on most desktops, or find Terminal in your applications.
2. Install the tools (one-time, Go 1.22+):

   sudo apt install golang-go git     # Debian / Ubuntu
   sudo dnf install golang git        # Fedora / RHEL

3. Copy-paste this and press Enter. git clone creates its own cloudless folder — don't make one yourself first, or you'll end up nested inside an extra empty folder of the same name:

   git clone https://github.com/asifontheline/cloudless
   cd cloudless/cloudless
   go build -o cloudless ./cmd/cloudless
   ./cloudless up