Maintenance Scripts - FileRise Docs

Scripts live in ./scripts in the repo (or /var/www/scripts in the Docker image). Most users never need to run them.

scan_uploads.php

Rebuilds per-folder metadata for files already on disk. Useful after copying files into uploads/ or after a restore.

Docker:

docker exec -u www-data -it filerise php /var/www/scripts/scan_uploads.php

Manual:

php /var/www/scripts/scan_uploads.php

Tip: SCAN_ON_START=true runs this once when the container starts.

Updates a manual install in /var/www from a release ZIP while keeping config/config.php and data folders.

Requirements: curl, unzip, rsync.

sudo bash /var/www/scripts/update-filerise.sh vX.Y.Z

Notes:

This script assumes the app lives in /var/www. If you installed elsewhere, edit WEBROOT inside the script.
Not for Docker. For Docker, pull a new image tag and recreate the container.

Demo server sync script with extra excludes and a forced FR_DEMO_MODE toggle. Do not use this on production installs.

Regenerates openapi.json.dist from annotations.

./scripts/gen-openapi.sh

Requires composer dependencies.

Updates asset cache-busters and version placeholders.

./scripts/stamp-assets.sh vX.Y.Z /path/to/repo

This updates ?v=... values and writes public/js/version.js.