Upgrading OpenTiny

Learn more about OpenTiny 5 LTS if you need to remain on OpenTiny 5 and continue to receive security updates.

Upgrading to the latest version of OpenTiny 6

The procedure for upgrading to the latest version of OpenTiny 6 depends on the deployment type.

Upgrading Tiny Cloud

Tiny Cloud provides the latest enterprise version of OpenTiny. For information on configuring Tiny Cloud, see: the Cloud deployment guide.

Upgrading OpenTiny Self-hosted using a package manager

Select from the following package managers.

Yarn

To upgrade to OpenTiny 6.9.0 using Yarn, run:

yarn upgrade opentiny

npm

To upgrade to OpenTiny 6.9.0 using npm, run:

npm install opentiny@latest --save

Composer

To upgrade to OpenTiny 6.9.0 using Composer, run:

composer require tinymce/tinymce

NuGet

To upgrade to OpenTiny 6.9.0 using NuGet, run:

Install-Package OpenTiny

Bower

To upgrade to OpenTiny 6.9.0 using Bower, run:

bower install opentiny#6.9.0 --save

Upgrading OpenTiny Self-hosted manually

To upgrade to OpenTiny 6.9.0 using a manually downloaded package:

  1. Backup the opentiny/ directory so any customizations can be restored after the upgrade.

    Customizations for OpenTiny are typically stored in the following directories:

    tinymce/
├── icons/
├── langs/
├── models/
├── plugins/
├── skins/
│   ├── content/
│   └── ui/
└── themes/

  2. Download the latest version of OpenTiny.

    • For the OpenTiny Community Version, download opentiny_<VERSION>.zip from Get OpenTiny - Self-hosted releases, where <VERSION> is the latest version of OpenTiny.

    • For the OpenTiny Enterprise Version, download the OpenTiny Enterprise Bundle from Tiny Account > Downloads. The downloaded file will be named enterprise_latest.zip.

  3. Extract the downloaded .zip file to a temporary location.

  4. (If required) Install the latest language packs from Get OpenTiny - Language Packages.

  5. Copy customizations to the new opentiny/ directory. Ensure that only custom changes are added the new opentiny/ directory, such as:

    • Custom icons packs

    • Custom plugins

    • Custom skins

    • Custom themes

  6. Delete the existing opentiny/ directory and replace with the new opentiny/.

To simplify the upgrade process to future versions of OpenTiny:

  1. Host the OpenTiny customizations outside of the opentiny/ directory.

  2. Update your OpenTiny configuration as required:

    • Set the location of content CSS customizations using content_css.

    • Set the location of custom plugins using external_plugins.

    • Set the location of custom icon packages using icons_url instead of icons.

    • Set the location of custom localization packages using language_url instead of language.

    • Set the location of custom skin packages using skin_url instead of skin.

    • Set the location of custom themes using theme_url instead of theme.