aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorDanilo M. <danix@danix.xyz>2026-07-01 09:51:34 +0200
committerDanilo M. <danix@danix.xyz>2026-07-01 09:51:34 +0200
commitd2b6e179aecb09d2d88bb72eba80502eea57ccc5 (patch)
treeac7ed4559e2e5d13f38c9208fc75c1b11034ac3f /README.md
parent59849d458b6bb71ed25efedde03d46acbab04d08 (diff)
downloadfirefly-update-d2b6e179aecb09d2d88bb72eba80502eea57ccc5.tar.gz
firefly-update-d2b6e179aecb09d2d88bb72eba80502eea57ccc5.zip
Verify download, validate extract, align artisan with official docs
Lessons from the community upgrade gist and the official self-managed upgrade docs: - Verify the downloaded zip against the release .sha256 (when sha256sum is available) and validate the extracted tree (artisan, bootstrap, vendor, the compiled frontend bundle) before the live swap, so a truncated or corrupt download cannot replace a working install. - Exclude storage/ from extraction since the live storage is carried over. - Match the official upgrade command sequence: migrate --seed, cache:clear, view:clear, firefly-iii:upgrade-database, firefly-iii:laravel-passport-keys. Adds the previously missing view:clear and switches from the generic passport:install to Firefly's firefly-iii:laravel-passport-keys. Keeps --force and the oauth migration reconcile. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Diffstat (limited to 'README.md')
-rw-r--r--README.md9
1 files changed, 8 insertions, 1 deletions
diff --git a/README.md b/README.md
index caf5f8f..13892bf 100644
--- a/README.md
+++ b/README.md
@@ -12,7 +12,14 @@ create-project`. The composer/Packagist dist ships source only and lacks the
compiled frontend bundles, which leaves the UI broken (no graphs, 404s on
`/v1/js/app.js`). The release zip is prebuilt.
-Requires `curl`, `unzip`, `php`, and `sqlite3` on the host.
+Requires `curl`, `unzip`, `php`, and `sqlite3` on the host. If `sha256sum` is
+present, the download is verified against the release checksum, and the
+extracted tree is validated (`artisan`, `bootstrap`, `vendor`, the compiled
+frontend bundle) before the live swap.
+
+The upgrade commands follow the official self-managed upgrade docs
+(`migrate --seed`, `cache:clear`, `view:clear`, `firefly-iii:upgrade-database`,
+`firefly-iii:laravel-passport-keys`), with `--force` for non-interactive use.
## Usage