Docs Developer Site
DeveloperDocsNext.xpStableReleaseUpgrade

Upgrading

Contents

Guillotine application

Guillotine version 7 is required if you need to modify graphql schema in your application.

Upgrading from v1.x

  1. Update env vars to:

    APP_NAME -> ENONIC_APP_NAME
remove CONTENT_API_MASTER
remove CONTENT_API_DRAFT
add ENONIC_API
API_TOKEN -> ENONIC_API_TOKEN
remove SITE_KEY
add ENONIC_PROJECTS=<repo-name>/site/path[,<lang>:<repo-name>/site/path,...]

  2. Add i18n config block to next.config.js

    i18n: {
    locales: ['en', 'no'],
    defaultLocale: 'en',
}

  3. Remove lib-nextxp dependency from your Enonic XP app build.gradle file

  4. Install Next.XP application from Enonic Market

  5. Create config file named com.enonic.app.nextxp.cfg in <xp-home>/config/ folder to change default values and add more configurations:

    # uncomment to override default values
# nextjs.default.secret=yourSecret
# nextjs.default.url=http://127.0.0.1:4242
#
# config 'someName'
nextjs.someName.secret=yourSecret
nextjs.someName.url=https://your.next-site.com
#
# config 'anotherName'
nextjs.anotherName.secret=yourOtherSecret
nextjs.anotherName.url=https://your.other-next-site.com
# ...
    Remember to update property values with your own data

  6. remove lib-guillotine dependency from build.gradle file of your Enonic XP app

  7. install Guillotine application from Enonic Market

    Use Guillotine 7 or higher if you need to extend the graphql schema

  8. Add Next.XP application to your site in every layer and save it

  9. Default configuration will be used automatically for each site. You can change it by going to Next.XP application config in each site and selecting named configurations.

Contents

Contents