Add swap setup and document x86 E2.1.Micro shape

Create a swap file during host setup so image builds don't OOM on the
1 GB E2.1.Micro shape, and document both Always Free shape options.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013vqQJQAud7rmfykwWKJACY

Author: claude

deploy/oracle/README.md

@@ -17,8 +17,11 @@ What you get:
 In the [OCI Console](https://cloud.oracle.com/) → **Compute → Instances → Create**:
 
 - **Image:** Canonical Ubuntu 22.04 (or Oracle Linux 9).
-- **Shape:** `VM.Standard.A1.Flex` (Ampere ARM, **Always Free** — e.g. 1–2 OCPUs,
-  6–12 GB RAM is plenty).
+- **Shape:** either Always Free option works:
+  - `VM.Standard.A1.Flex` (Ampere ARM) — more RAM, but see the logviewer ARM
+    note under Troubleshooting.
+  - `VM.Standard.E2.1.Micro` (x86, 1 OCPU / 1 GB RAM) — logviewer runs natively;
+    `setup.sh` adds a swap file to handle the 1 GB limit during image builds.
 - **SSH keys:** upload/download a key pair so you can log in.
 - Note the instance's **public IP** after it boots.
 

deploy/oracle/setup.sh

@@ -13,6 +13,18 @@
 set -euo pipefail
 
 LOGVIEWER_PORT=8000
+SWAP_SIZE=2G
+
+echo "==> Ensuring swap exists (important on 1 GB shapes like E2.1.Micro)..."
+if ! sudo swapon --show | grep -q '/swapfile'; then
+    sudo fallocate -l "${SWAP_SIZE}" /swapfile || sudo dd if=/dev/zero of=/swapfile bs=1M count=2048
+    sudo chmod 600 /swapfile
+    sudo mkswap /swapfile
+    sudo swapon /swapfile
+    grep -q '/swapfile' /etc/fstab || echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
+else
+    echo "    Swap already present, skipping."
+fi
 
 echo "==> Installing Docker Engine + Compose plugin..."
 if ! command -v docker >/dev/null 2>&1; then