Updating the CMS

Starting with 3.6 the panel notifies you about a new core version (badge on the “Marketplace” menu item and a card on the dashboard). Plugins and themes from the marketplace update with the “Update” button; the core is updated manually with the steps below.

Steps

  1. Back up: export the database, copy .env, storage/, public/uploads/.
  2. Download the new release: https://celena.io/downloads/celena-cms-3.6.1.zip
  3. Copy files over the site: core/, modules/, config/, bin/, public/assets/, bundled plugins (plugins/leads|shop|analytics|handbook), themes default/admin/commerce, index.php, admin.php, .htaccess. Do not touch .env, storage/, public/uploads/, install.lock or your own plugins/themes. Do not copy install.php.
  4. Clear cache: delete files in storage/cache/ (find storage/cache -type f -delete).
  5. Open the site and the panel — database migrations run automatically (or php bin/celena migrate).

3.5 → 3.6 notes

  • Add the marketplace public key to .env (present in the new .env.example): MARKETPLACE_PUBKEY="6q2vesNDnmG4QuwMh7NUCo+2V8SNYSs2HwcAIbnVnew=" — without it package signatures are not verified.
  • Set chmod 600 .env.
  • Check the notification recipients of your lead form: “Leads → Forms”.
  • Mark your own packages that must never reach the marketplace with a .private file in their root.

The full list of changes is in CHANGELOG.md in the site root.