The Application Definition page enables you to manage the requirements of your Nuxeo Studio project and your application.
Main Options
- Nuxeo Server Version: Studio will generate valid configuration for this Nuxeo Server version.
- Packages: The list of additional dependencies needed to make your application work. Selected dependencies will be automatically installed when you deploy your Nuxeo Studio configuration on your server.
Any Nuxeo public or private addon uploaded in the Nuxeo Marketplace can be selected. Type a character to start filtering them. The title and description are provided for each addon to help you select the package you need.
Some addons bring additional options into Studio such as new screens or options, making their configuration easier. Once you select addons impacting Studio, their specific features are instantly available.
Addons that display a Private tag mean they have been uploaded on the marketplace through the private channel.
You can select the version of added packages, remove existing packages, or change the version of already installed packages. No change is kept until you manually press the save button. Pending changes are displayed so that you can assess what will be added or removed and undo it if necessary. Each dependency line is color-coded according to its status: ADDED REMOVED CHANGED INSTALLED
Managing Package Versions During LTS Upgrade in Nuxeo Studio
When you change the Nuxeo Server version on the Application Definition page, Nuxeo Studio adapts the package list to the target LTS. The Packages list uses background colors to show what will happen to each package when you click Save.
Screenshot of the Application Definition interface after selecting a new Nuxeo Server version. The background colors of the packages are explained below.
If a previously selected package is unavailable for your new Nuxeo Server version, Nuxeo Studio lists it under removed packages to alert you. Available packages automatically upgrade to the latest version compatible with the new server.
What Each Color Means
- Blue: Package will be upgraded to the latest version compatible with the target LTS. Old and new versions are shown side by side (e.g.
Nuxeo Drive 2023.47.14 → 2025.19.14). - Red: Package will be removed when you save (e.g.
Aspera Connector). - Green: Package will be added when you save (e.g.
Nuxeo JSF To Web UI). - White (unhighlighted): Package version is locked and will be left as-is. Studio will not auto-upgrade it when you switch LTS versions (e.g.
Nuxeo Web UI).
Locking a version across an LTS migration is rarely appropriate, as most packages are not compatible across LTS versions. If the locked version is not available for the target LTS, the Version dropdown appears empty and a compatible version must be selected manually.
Some exceptions requiring a manual change may still happen and are listed in the specific upgrade instructions page.
Using the ❌ Button
The red X button on the right of each package row behaves as follows:
- First click: The package turns white. Its version is locked and will not be auto-updated on future LTS switches.
- Second click: The package turns red. It is marked for removal and will be deleted when you click Save.
Adding a Package
Adding a new package from the search field shows it in green. It will be installed when you click Save.
