Clarify quick-deploy image updates and restore useful command output

Author: pRizz

README.md

@@ -21,7 +21,7 @@ This project uses the opencode fork at https://github.com/pRizz/opencode, which
 
 ## Quick Deploy (Docker)
 
-Deploy opencode-cloud with one command. Installs Docker if needed (Linux), downloads or refreshes the Docker Compose config, starts the service, and prints the login credentials:
+Deploy opencode-cloud with one command. Installs Docker if needed (Linux), downloads or refreshes the Docker Compose config, pulls the latest `prizz/opencode-cloud-sandbox:latest` image, reconciles services, and prints the login credentials:
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/pRizz/opencode-cloud/main/scripts/quick-deploy.sh | bash
@@ -37,6 +37,8 @@ Then open [http://localhost:3000](http://localhost:3000) and enter the Initial O
 
 > **Compose refresh behavior:** By default, the script fetches the latest upstream `docker-compose.yml`. If your local file differs, it is replaced and a backup is written as `docker-compose.yml.bak.<timestamp>`.
 
+> **Image refresh behavior:** By default, the script runs `docker compose pull` before `docker compose up -d`, so rerunning quick deploy updates to the latest image.
+
 ## Quick install (cargo)
 
 ```bash
@@ -118,7 +120,7 @@ SSH into an Ubuntu 24.04 Droplet and run:
 curl -fsSL https://raw.githubusercontent.com/pRizz/opencode-cloud/main/scripts/quick-deploy.sh | bash
 ```
 
-This installs Docker, by default refreshes the Compose file from upstream (with backup if your local copy differs), starts the service, and prints the IOTP.
+This installs Docker, by default refreshes the Compose file from upstream (with backup if your local copy differs), pulls the latest image, reconciles services, and prints the IOTP.
 
 Access via SSH tunnel: `ssh -L 3000:localhost:3000 root@<droplet-ip>`, then open `http://localhost:3000`.
 

docs/deploy/digitalocean-droplet.md

@@ -234,7 +234,7 @@ Use this if you don't want `occ` installed on the Droplet.
 
 Docker Compose configures all 6 named volumes automatically.
 
-The quickest way is the one-liner script, which installs Docker, by default refreshes the Compose file from upstream (with backup if your local copy differs), starts the service, and prints the IOTP:
+The quickest way is the one-liner script, which installs Docker, by default refreshes the Compose file from upstream (with backup if your local copy differs), pulls the latest image, reconciles services, and prints the IOTP:
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/pRizz/opencode-cloud/main/scripts/quick-deploy.sh | bash

docs/deploy/docker-desktop.md

@@ -15,7 +15,7 @@ No cloud account or `occ` CLI installation is required.
 
 ## Quick Start (One-Liner)
 
-The fastest path — installs Docker if needed, downloads or refreshes the Compose config, starts the service, and prints the IOTP:
+The fastest path — installs Docker if needed, downloads or refreshes the Compose config, pulls the latest image, reconciles services, and prints the IOTP:
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/pRizz/opencode-cloud/main/scripts/quick-deploy.sh | bash
@@ -27,6 +27,8 @@ curl -fsSL https://raw.githubusercontent.com/pRizz/opencode-cloud/main/scripts/q
 
 > By default, if local `docker-compose.yml` differs from upstream, the script replaces it and writes a backup as `docker-compose.yml.bak.<timestamp>`.
 
+> By default, the script runs `docker compose pull` before `docker compose up -d`, so rerunning quick deploy updates to the latest image.
+
 ## Quick Start (Docker Compose)
 
 The project includes a `docker-compose.yml` that configures all persistent

packages/core/README.md

@@ -21,7 +21,7 @@ This project uses the opencode fork at https://github.com/pRizz/opencode, which
 
 ## Quick Deploy (Docker)
 
-Deploy opencode-cloud with one command. Installs Docker if needed (Linux), downloads or refreshes the Docker Compose config, starts the service, and prints the login credentials:
+Deploy opencode-cloud with one command. Installs Docker if needed (Linux), downloads or refreshes the Docker Compose config, pulls the latest `prizz/opencode-cloud-sandbox:latest` image, reconciles services, and prints the login credentials:
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/pRizz/opencode-cloud/main/scripts/quick-deploy.sh | bash
@@ -37,6 +37,8 @@ Then open [http://localhost:3000](http://localhost:3000) and enter the Initial O
 
 > **Compose refresh behavior:** By default, the script fetches the latest upstream `docker-compose.yml`. If your local file differs, it is replaced and a backup is written as `docker-compose.yml.bak.<timestamp>`.
 
+> **Image refresh behavior:** By default, the script runs `docker compose pull` before `docker compose up -d`, so rerunning quick deploy updates to the latest image.
+
 ## Quick install (cargo)
 
 ```bash
@@ -118,7 +120,7 @@ SSH into an Ubuntu 24.04 Droplet and run:
 curl -fsSL https://raw.githubusercontent.com/pRizz/opencode-cloud/main/scripts/quick-deploy.sh | bash
 ```
 
-This installs Docker, by default refreshes the Compose file from upstream (with backup if your local copy differs), starts the service, and prints the IOTP.
+This installs Docker, by default refreshes the Compose file from upstream (with backup if your local copy differs), pulls the latest image, reconciles services, and prints the IOTP.
 
 Access via SSH tunnel: `ssh -L 3000:localhost:3000 root@<droplet-ip>`, then open `http://localhost:3000`.
 

scripts/quick-deploy.sh

@@ -521,19 +521,20 @@ start_services() {
     info "Container '$CONTAINER_NAME' is already running"
     info "  Container ID: $container_id"
     info "  Image:        $image"
-    info "  Restart: $COMPOSE_CMD restart"
-    info "  Stop:    $COMPOSE_CMD down"
-    return 0
+    info "  Updating image and reconciling services..."
   fi
 
-  if ! confirm "Start opencode-cloud?"; then
-    info "Skipping service start. Run manually: $COMPOSE_CMD up -d"
+  if ! confirm "Pull latest image and ensure opencode-cloud is running?"; then
+    info "Skipping service start/update. Run manually: $COMPOSE_CMD pull && $COMPOSE_CMD up -d"
     return 0
   fi
 
+  info "Pulling latest image..."
+  $COMPOSE_CMD pull
   $COMPOSE_CMD up -d
   container_id="$(get_container_id)"
-  success "Services started (container: ${container_id:-unknown})"
+  success "Services ready (container: ${container_id:-unknown})"
+  display_useful_commands
 }
 
 # ---------------------------------------------------------------------------