Skip to content

Comments

docs: Add Oracle Cloud (OCI) platform guide#2333

Merged
vignesh07 merged 8 commits intoopenclaw:mainfrom
hirefrank:docs/add-oracle-cloud-guide
Jan 26, 2026
Merged

docs: Add Oracle Cloud (OCI) platform guide#2333
vignesh07 merged 8 commits intoopenclaw:mainfrom
hirefrank:docs/add-oracle-cloud-guide

Conversation

@hirefrank
Copy link
Contributor

@hirefrank hirefrank commented Jan 26, 2026

Summary

  • Add comprehensive guide for Oracle Cloud Always Free tier (ARM) at docs/platforms/oracle.md
  • Cover VCN security, Tailscale Serve setup, and why traditional VPS hardening (UFW, fail2ban, sshd) is unnecessary with OCI's network-edge firewall
  • Update docs/vps.md to list Oracle as top provider option ($0/month)

Why Oracle Cloud?

Oracle's Always Free tier offers significantly more resources than paid alternatives:

Provider Specs Price
Oracle Cloud 4 OCPU, 24GB RAM $0/month
Hetzner CX22 2 vCPU, 4GB RAM ~$4/month
DigitalOcean 1 vCPU, 1GB RAM $6/month

The guide covers the unique security model where OCI's VCN blocks traffic at the network edge, making host-based firewalls redundant.

Test plan

  • Verify markdown renders correctly on docs site
  • Check all internal links resolve (/platforms/oracle, /gateway/tailscale, etc.)
  • Confirm YAML frontmatter matches other platform guides

🤖 Generated with Claude Code

@openclaw-barnacle openclaw-barnacle bot added the docs Improvements or additions to documentation label Jan 26, 2026
@vignesh07 vignesh07 self-assigned this Jan 26, 2026
@hirefrank
Copy link
Contributor Author

One thing I'm not 100% sure about: I couldn't figure out how to avoid getting "disconnected (1008): pairing required" in the Control UI without setting:

clawdbot config set gateway.controlUi.allowInsecureAuth true

With Tailscale Serve handling HTTPS and identity headers, I assumed device pairing wouldn't be needed — but without this flag the UI wouldn't connect.

I welcome any tips on the "correct" way to handle this. Is there a better configuration for Tailscale Serve setups that avoids needing allowInsecureAuth?

hirefrank and others added 8 commits January 26, 2026 11:14
- Add comprehensive guide for Oracle Cloud Always Free tier (ARM)
- Cover VCN security, Tailscale Serve setup, and why traditional hardening is unnecessary
- Update vps.md to list Oracle as top provider option
- Update digitalocean.md to link to official Oracle guide instead of community gist

Co-Authored-By: Claude Opus 4.5 <[email protected]>
@vignesh07 vignesh07 force-pushed the docs/add-oracle-cloud-guide branch from 6c572ff to cf7f77b Compare January 26, 2026 19:17
@openclaw-barnacle openclaw-barnacle bot added the channel: discord Channel integration: discord label Jan 26, 2026
@vignesh07 vignesh07 merged commit 10d5ea5 into openclaw:main Jan 26, 2026
21 of 23 checks passed
@vignesh07
Copy link
Contributor

Landed via temp rebase onto main.

  • Gate (local): pnpm install --frozen-lockfile, pnpm lint, pnpm format (fixed), pnpm build (pnpm test has some local env failures; GitHub Actions checks were green/pending at merge time and merge completed)
  • Land commit: cf7f77b
  • Merge commit: 10d5ea5

Thanks @hirefrank!