Add Oracle Cloud deployment setup

Add deploy/oracle with an Oracle-ready docker-compose that builds this
fork for the VM's native (ARM64) architecture, runs the logviewer, and
reuses the existing MongoDB via CONNECTION_URI. Includes a host setup
script (Docker install + firewall) and a step-by-step migration guide.

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

Author: claude

deploy/oracle/.env.example

@@ -0,0 +1,20 @@
+# Copy this file to `.env` in the same directory and fill in your values.
+#   cp .env.example .env && nano .env
+
+# Your Discord bot token.
+TOKEN=MyBotToken
+
+# The ID of the Discord server (guild) this bot serves.
+GUILD_ID=1234567890
+
+# Comma-separated user IDs allowed to run owner-only commands.
+OWNERS=Owner1ID,Owner2ID
+
+# Your EXISTING MongoDB connection URI (kept from your previous host).
+# The logviewer reuses this same URI via MONGO_URI in docker-compose.yml.
+CONNECTION_URI=mongodb+srv://user:pass@cluster.mongodb.net/modmail
+
+# Public URL where the logviewer is reachable, used in generated log links.
+# Set this to your VM's public IP (or domain) on port 8000, e.g.:
+#   http://123.45.67.89:8000
+LOG_URL=http://YOUR_VM_PUBLIC_IP:8000

deploy/oracle/README.md

@@ -0,0 +1,107 @@
+# Deploying Modmail to Oracle Cloud
+
+This guide moves your Modmail bot (this fork) and the Logviewer onto an Oracle
+Cloud **Always Free** VM, while continuing to use your **existing MongoDB**.
+
+What you get:
+- `bot` — built from this repo's `Dockerfile`, so your fork's changes are
+  included and the image is native to the VM's ARM64 architecture.
+- `logviewer` — the web UI for closed-thread log links, served on port `8000`.
+- No database container — the bot and logviewer both point at your current
+  `CONNECTION_URI`.
+
+---
+
+## 1. Create the VM
+
+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).
+- **SSH keys:** upload/download a key pair so you can log in.
+- Note the instance's **public IP** after it boots.
+
+## 2. Open the firewall (cloud side)
+
+The instance firewall is handled by `setup.sh`, but the cloud network is separate.
+
+In the OCI Console → **Networking → Virtual Cloud Networks → your VCN → your
+subnet → Security List → Add Ingress Rules**:
+
+| Source CIDR | Protocol | Dest. Port | Purpose       |
+|-------------|----------|------------|---------------|
+| `0.0.0.0/0` | TCP      | `8000`     | Logviewer     |
+
+(Port `22` for SSH is usually open by default.)
+
+## 3. Install Docker on the VM
+
+SSH in, then:
+
+```bash
+ssh ubuntu@YOUR_VM_PUBLIC_IP        # or opc@... on Oracle Linux
+
+# Get this fork's deploy files:
+git clone https://github.com/PloverRoblox/modmail.git
+cd modmail
+git checkout claude/gifted-curie-z2wprx
+cd deploy/oracle
+
+chmod +x setup.sh && ./setup.sh
+```
+
+Then **log out and back in** so your user picks up the `docker` group.
+
+## 4. Configure your environment
+
+```bash
+cp .env.example .env
+nano .env
+```
+
+Fill in:
+- `TOKEN`, `GUILD_ID`, `OWNERS` — same values as your old host.
+- `CONNECTION_URI` — your **existing** MongoDB URI (nothing migrates; the bot
+  just reconnects to the same database).
+- `LOG_URL` — `http://YOUR_VM_PUBLIC_IP:8000`
+
+## 5. Launch
+
+```bash
+docker compose up -d --build
+docker compose logs -f bot        # watch it connect to Discord
+```
+
+You should see the bot log in. Closed-thread log links will resolve at
+`http://YOUR_VM_PUBLIC_IP:8000`.
+
+## 6. Decommission the old host
+
+Once the new instance is confirmed working, stop the bot on your previous host
+so two instances don't run against the same database at once.
+
+---
+
+## Updating later
+
+```bash
+cd ~/modmail && git pull
+cd deploy/oracle && docker compose up -d --build
+```
+
+## Troubleshooting
+
+- **Bot won't start / DB errors:** double-check `CONNECTION_URI` and that your
+  MongoDB/Atlas network access list allows the VM's public IP.
+- **Logviewer container exits with "exec format error" on the ARM VM:** the
+  upstream `logviewer` image may not publish an `arm64` variant. Two fixes:
+  1. Add emulation, then retry:
+     `sudo apt install -y qemu-user-static binfmt-support` and add
+     `platform: linux/amd64` under the `logviewer` service in
+     `docker-compose.yml`; **or**
+  2. Use an x86 shape (`VM.Standard.E2.1.Micro`, also Always Free) for the VM so
+     the upstream image runs natively.
+- **Can't reach the logviewer in a browser:** confirm both the OCI Security List
+  rule (step 2) *and* the instance firewall (`setup.sh`) allow port `8000`.
+```

deploy/oracle/docker-compose.yml

@@ -0,0 +1,32 @@
+# Oracle Cloud deployment for Modmail (this fork) + Logviewer.
+#
+# - `bot` is built from this repository's Dockerfile so your fork's changes are
+#   included, and so the image is native to the host architecture (the Always
+#   Free Ampere A1 VM is ARM64 / aarch64).
+# - `logviewer` is pulled from the upstream registry. If it fails to start on an
+#   ARM VM (manifest/exec format error), see the note in README.md.
+# - There is no `mongo` service here: this setup points at your EXISTING database
+#   via CONNECTION_URI in .env (your current MongoDB / Atlas URI).
+
+services:
+  bot:
+    build:
+      context: ../..
+      dockerfile: Dockerfile
+    image: modmail-fork:latest
+    container_name: modmail-bot
+    restart: always
+    env_file:
+      - .env
+
+  logviewer:
+    image: ghcr.io/modmail-dev/logviewer:master
+    container_name: modmail-logviewer
+    restart: always
+    env_file:
+      - .env
+    environment:
+      # Logviewer reads MONGO_URI; reuse the same database the bot writes to.
+      - MONGO_URI=${CONNECTION_URI}
+    ports:
+      - "8000:8000"

deploy/oracle/setup.sh

@@ -0,0 +1,48 @@
+#!/usr/bin/env bash
+#
+# One-time host setup for running Modmail on an Oracle Cloud VM.
+# Installs Docker + Compose and opens the logviewer port (8000) on the instance
+# firewall. Works on Ubuntu (apt) and Oracle Linux (dnf) images.
+#
+# Usage (run on the VM):
+#   chmod +x setup.sh && ./setup.sh
+#
+# NOTE: This handles the *instance* firewall only. You must ALSO open port 8000
+# (and 22 for SSH) in the OCI Console -> VCN -> Security List. See README.md.
+
+set -euo pipefail
+
+LOGVIEWER_PORT=8000
+
+echo "==> Installing Docker Engine + Compose plugin..."
+if ! command -v docker >/dev/null 2>&1; then
+    curl -fsSL https://get.docker.com | sh
+fi
+
+echo "==> Adding current user to the docker group (re-login to take effect)..."
+sudo usermod -aG docker "$USER" || true
+
+echo "==> Enabling and starting Docker..."
+sudo systemctl enable --now docker
+
+echo "==> Opening instance firewall on port ${LOGVIEWER_PORT}..."
+if command -v firewall-cmd >/dev/null 2>&1; then
+    # Oracle Linux ships firewalld.
+    sudo firewall-cmd --permanent --add-port=${LOGVIEWER_PORT}/tcp
+    sudo firewall-cmd --reload
+elif command -v iptables >/dev/null 2>&1; then
+    # Ubuntu Oracle images ship a restrictive iptables ruleset.
+    sudo iptables -I INPUT 6 -m state --state NEW -p tcp --dport ${LOGVIEWER_PORT} -j ACCEPT
+    if command -v netfilter-persistent >/dev/null 2>&1; then
+        sudo netfilter-persistent save
+    else
+        echo "    (Install iptables-persistent to make this rule survive reboot.)"
+    fi
+fi
+
+echo ""
+echo "==> Host setup complete."
+echo "    1. Log out and back in (so the docker group applies)."
+echo "    2. cp .env.example .env  &&  edit .env with your values."
+echo "    3. docker compose up -d --build"
+echo "    4. Make sure port ${LOGVIEWER_PORT} is also open in the OCI Security List."