Common issues and solutions for migration.

Database Migration Issues

Permission denied: Ensure the database file has correct ownership and permissions.

Fatal error creating tmp directory: Configure server.cacheDir in your config file and ensure filesystem permissions match.

Database locked: Ensure original FileBrowser instance is stopped.

User Migration Issues

Can’t log in with old credentials: Verify database migration was successful and database file has correct permissions. You can also reset via CLI if needed.

User permissions not working: Check userDefaults in config.yaml doesn’t override individual user settings.

2FA blocking access: Disable 2FA temporarily by updating user in database or via API.

Next Steps