Migration Path

Since Scroll Sites on On-prem and Cloud are technically different apps, migration requires a hands-on approach. This guide will walk you through the process.

If you would like personalized advice on how to move your viewports to cloud, you can either send us a viewport usage report (requires minimum Scroll Sites 2.25.2) or provide screenshots:

Option 1 – Get the usage report:

• Navigate to <your Confluence base URL>/rest/scroll-viewport/1.0/support, copy the results to a .txt file, and send it to us.

• Please also send us the most customized theme that is in use. Follow the instructions to download the theme.

Option 2 – Do it manually (if you do not want to update):
Take screenshots from:

• General Configuration > Scroll Sites/Scroll Viewport > Viewports

• General Configuration > Scroll Sites/Scroll Viewport > Themes

• General Configuration > Macro Usage > Scroll Sites/Scroll Viewport or Scroll Runtime for Confluence

Please also send us the most customized theme that is in use. Follow the instructions to download the theme.

Migration Steps

These steps will explain how you can move your viewports to Confluence Cloud.

Step-1: Migrate content to Confluence Cloud

• Migrate your Confluence spaces to your Confluence Cloud instance by using Confluence Cloud Migration Assistant.

  • Atlassian's migration guide from Confluence on-prem to Confluence Cloud

Step-2: Create a new Scroll site

1. In the Confluence sidebar navigation click on "Apps".

2. Choose "Scroll Sites" from the dropdown.

3. Click on "Create new site".

4. Go through the site creation wizard following the steps on Create a New Scroll Site .

5. In the “Set up your site” step, make sure to create an ‘unpublished site’.

6. In the “Add content” step, make sure you add your imported space as the content for your site.

7. Click “Create”.

Step-3: Apply theme settings

If you are using Help Center theme, the theme settings in the theme editor on Confluence Cloud are in the same order and work the same as they are on Confluence On-prem.

On your Confluence On-prem Instance

1. Navigate to your Viewport settings (General Configuration > Scroll Sites > Viewports > Configure)

2. Open the theme editor of your applied Help Center theme.

3. Download all attached images you use within the theme.

4. Open the theme editor of your applied Help Center theme.

5. Open theme-settings.properties file.

On your Confluence Cloud Instance

1. Open Scroll Sites from Apps > Scroll Sites

2. From the My Sites screen, find the card for the site you want to customize.

3. Click Site Settings > Look and feel > Customize theme. The theme configurator will open.

4. Compare the settings of your theme-settings.properties file and the settings in the theme configurator.

5. Adjust the settings accordingly.

6. Once done, save the theme and close the configurator.

(Optional) Step-4: Set up your custom domain and redirects

On your Confluence On-prem Instance

1. In the viewport spaces, find all redirect macros and note down the redirects (General Configuration > Macro Usage)

2. Go to your Confluence's General configuration > Scroll Sites > URL Redirects. Note down all redirects here as well.

You should also take care to remove any existing CNAME records from your DNS configuration before you proceed.

On your Confluence Cloud Instance

1. Follow all the steps on Connect a custom domain

2. Follow the steps to set up your literal redirects or regex redirects

Step-6: Bring your site live

1. In Scroll Sites on Cloud, for the site you created click on "Go live" from the sidebar.
   Depending on the size of the space, this might take a while but doesn't require your attention.

Once your Scroll site is live it is accessible publicly through the given URL defined in Step-2.

Learn more about:

• The update process

• How to setup a Custom Domain for your Scroll site.

• Which macros are currently supported.