Skip to main content

​
Update Process

Updates are pulled from the Verilock Docker registry. Your data and configuration are preserved.

​
1. Check for updates

docker compose exec app php artisan selfhost:check-update
Output: 
Current version: v1.0.0
Update channel: stable

New version available: v1.1.0

Release notes:
- Added batch document upload
- Improved AML matching accuracy
- Fixed session expiry edge case

To update, run:
  docker compose pull && docker compose up -d && php artisan migrate --force

# Database
docker compose exec postgres pg_dump -U verilock verilock > backup-$(date +%Y%m%d).sql

# Document storage
docker compose exec minio mc mirror local/verilock-documents ./backup-documents/

​
3. Pull and restart

docker compose pull
docker compose up -d
The entrypoint automatically runs migrations and caches configuration on startup.

​
4. Verify

docker compose exec app php artisan license:heartbeat
Never skip major versions. If you’re on v1.x and the latest is v3.x, upgrade through v2.x first. Check the changelog for migration guides.

​
Update Channels

ChannelDescriptionRecommended For
stableProduction-tested releasesAll deployments
betaEarly access to new featuresStaging environments
Change your channel in .env: 
VERILOCK_UPDATE_CHANNEL=beta

​
Rollback

If an update causes issues: 
# Stop current version
docker compose down

# Pull specific version
docker compose pull app:1.0.0

# Or edit docker-compose.yml to pin the version:
# image: verilock/identity:1.0.0

# Restart
docker compose up -d
Database migrations are forward-only. If you need to rollback a migration, contact support.

​
Version Support Policy

StatusSupport LevelDuration
CurrentFull support, bug fixes, security patchesOngoing
PreviousSecurity patches only6 months after next release
EOLNo support—
Your license heartbeat will notify you when your version approaches EOL.