Test it on a lab or non-production server first. The upgrade from 1.5 to 1.6 is one-way: it changes the database schema, and there is no down-migration.

Changed since RC-6

• FOS check-in failed behind Apache’s forced HTTPS (#1835, issue #1829). Check-in failed with “Invalid MAC Address!” and registration with “No viable macs to use”. The redirect turned FOS’s POST into an empty GET. It now keeps the POST. Re-run the installer to apply it.
• Legacy FOG Client: “Thumbprints did not match” after restoring an old root CA (#1837). The installer kept a client communication certificate that the restored root did not sign. It now re-issues that certificate under the current root, with the same key. Registered clients need no reinstall.
• Schema update stopped at step 344 on MySQL (#1840). It failed with 1067 Invalid default value for 'hostSecTime' on databases first built on MySQL 5.x. The schema updater now completes.
• Install failed with “Could not download bzImage32 properly” (#1842). A short GitHub error page was saved as the kernel and as its checksum file. The installer now treats an HTTP error as a failed download and logs the reason. If you already hit this, delete /root/fogproject/tmp/bzImage32* (or the file it names) and re-run the installer.

Before you upgrade

• Back up your database and /opt/fog/.fogsettings.
• Read the release notes: https://github.com/FOGProject/fogproject/blob/rc-1.6.0/docs/release/1.6.0-release-notes.md
• 1.6 removes Display Manager, Directory Cleaner, User Cleanup, Client Updater, Green FOG and the persistentgroups plugin. Their data is dropped. The site and accesscontrol plugins move into core.
• PHP 7.4 or later is required. Plugins built for 1.5 do not load.

Install or update (as root)

• A 1.6 beta or RC server: run bin/updatefog.sh --channel rc from your FOG checkout.
• A 1.5 server installed from git: update to the current 1.5 stable, then run bin/updatefog.sh --channel rc from the checkout.
• A new server, or a 1.5 server installed from a tarball:
  curl -fsSL https://raw.githubusercontent.com/FOGProject/fogproject/working-1.6/bin/bootstrap.sh | bash -s -- --channel rc

Report problems

Open an issue at https://github.com/FOGProject/fogproject/issues. Include your FOG version, your OS, and the installer log from bin/error_logs/. Report a security problem through “Report a vulnerability” on the same repository, not in a public issue.