Nelios Uploads

Nelios Uploads is a CMS5-exclusive plugin that wraps the Strapi media upload plugin to enable per-user permissions in a multisite setup.

Adding a New Site

To register a new site, locate the following file in the cms5-backend repository:

config/plugins.ts

Add the site identifier to the config.sites array of the nelios-uploads plugin.

export default ({
  // …other plugins
  'nelios-uploads': {
    enabled: true,
    // resolve: './src/plugins/nelios-uploads',
    config: {
      sites: ['andronis', 'pantheonWaterpark', 'uzenie', 'add_here']
    }
  },
  // …other plugins
});

Note: The key name (e.g., andronis) must match the site identifier used by the plugin.

Usage

For each existing media field, create a new field with the same name plus the _NELIOS suffix. (This was done for backwards-compatibility reasons, since the change was introduced while sites were already on production.)

Example:

• FeaturedImage — the standard Strapi media field, hidden from clients
• FeaturedImage_NELIOS — our custom field

Automated migration for live sites

For sites that are already live, this process can be done automatically by running a series of migration scripts.

1. Locally, stop Strapi.
2. Run the scripts in this order:

pnpm run nelios-uploads-migrate
pnpm run nelios-uploads-migrate-sitesmanager
pnpm run nelios-uploads-migrate-components
pnpm run nelios-uploads-migate-site-components

Each script will prompt you for the name of your site.

Then build everything:

pnpm run buildAll

Review the changes locally!

These migration scripts look for shared components, copy them for your site, and adjust them there, using the extensions to apply any changes. They should not affect any site other than the one you provided as input.

Migrating existing field data

If the original field already had content, leave the new _NELIOS field empty and click Save/Publish — the content will be transferred automatically to the new field.