Skip to content

armgit / ODS

Public Imported from GitHub
0

ODS V3 Pre-Release: Public testing and refinement ahead of the official V3 launch. Turn your PC, Mac, or Linux box into a private AI server.

2.0 KB
Raw Blame

Private dashboard state on macOS

The dashboard API stores image attachments and retained chat responses in two Docker named volumes. Their private SQLite files stay on the Docker VM's local filesystem. Other dashboard data and model caches keep their existing locations.

The installer prepares these volumes before starting the API. On an existing installation, the first migration requires the API to be stopped:

./ods-macos.sh stop
./ods-macos.sh start

Migration retains the original data/pixel-images and data/pixel-chat-results directories and private snapshots under data/.dashboard-private-stores. Successful later starts reuse the volumes; they never copy those old directories over newer state. Existing image deletion fences and incomplete chat attempts are retained. Restarting the API does not make an incomplete attempt complete.

Use the ordinary ODS backup/restore commands. Image snapshots still appear as data/pixel-images in archives. Short-lived chat delivery receipts remain excluded. The existing restriction on backing up/restoring managed native Pixel state still applies; this storage change does not make native archives supported.

An interrupted restore blocks API starts until its saved transaction is resolved. data/.dashboard-private-stores/image-restore-active.json identifies the private transaction directory. With the API stopped, the transfer helper can roll it back:

python3 installers/macos/lib/dashboard-private-state.py rollback \
  --install-dir "$PWD" --path /exact/transaction/directory/from/the/record

Keep the transaction, original directories and volumes if rollback reports an error. Do not delete a receipt, change ownership or import an old host directory to bypass a refusal. A changed legacy database after an interrupted migration requires reconciliation of both retained copies before another migration. ods-uninstall.sh --keep-data preserves the volumes; ordinary removal accounts for their exact installation and creation receipts, including failed first starts.