Update README.md

README.md

@@ -1,23 +1,21 @@
 ---
-title: OpenCode Web (HF Bucket Persistent)
+title: OpenCode Web (Persistent via HF Bucket Backup)
 sdk: docker
 app_port: 7860
 ---
 
 This Space runs `opencode web` on port 7860.
 
-Persistence:
-- Mount a Hugging Face **Storage Bucket** to `/data` in Space Settings (Read & Write).
-- We do NOT run SQLite directly on the mounted bucket.
-  Instead:
-  - OpenCode runs with its DB on the local (ephemeral) disk.
-  - A background job periodically performs a safe SQLite `.backup` to `/data/opencode-backup/`.
-  - On startup, if a backup exists, it restores the DB back to local disk.
+### Why not write to /data directly?
+Even if a Storage Bucket is mounted to `/data`, it can be mounted via FUSE with permissions that are not writable by the runtime UID=1000 user. In that case, we persist by **uploading backups to the bucket via `hf buckets cp`** instead of writing to `/data`.
 
-Required Secrets:
-- OPENCODE_SERVER_PASSWORD (required)
+### Required Secrets (Space Settings -> Secrets)
+- `OPENCODE_SERVER_PASSWORD` (required)
+- `HF_TOKEN` (required for persistence; must have write access to your bucket)
 
-Optional:
-- OPENCODE_SERVER_USERNAME
-- OPENCODE_CONFIG_CONTENT (inline JSON content)
-- BACKUP_INTERVAL_SECONDS (default 60)
+### Required Variables (Space Settings -> Variables)
+- `HF_BUCKET_ID` (example: `habppyar/ocweb-storage`)
+
+### Optional Variables
+- `BACKUP_INTERVAL_SECONDS` (default: 120)
+- `BUCKET_PREFIX` (default: `opencode-backup`)