Breadcrumbs

Cloud Migration Guide

Atlassian has announced the end-of-life for Confluence Data Center. PocketQuery is fully available on Confluence Cloud, and migrating your PocketQuery entities is straightforward. This guide walks you through the process step by step.

Prerequisites

  • A Confluence Data Center instance

  • A Confluence Cloud instance

  • The latest version of PocketQuery installed on both instances

  • Confluence Administrator permissions

Step 1: Migrate Your Confluence Content to Cloud

First, migrate your Confluence pages and spaces.

Follow Atlassian’s official Cloud Migration Guide to move your Confluence content from Data Center to Cloud.

PocketQuery entities are not included in the Atlassian content migration and must be migrated separately using the steps below.

Step 2: Export PocketQuery Entities from Data Center

In your Data Center instance:

  1. Go to Administration → PocketQuery → Import/Export

  2. Under Global Export, click Export

  3. An XML file containing all PocketQuery entities will be downloaded:

    • Datasources

    • Queries

    • Templates

    • Converters

Step 3: Import PocketQuery Entities into Cloud

In your Cloud instance:

  1. Open Apps → PocketQuery → Import/Export

  2. Upload the XML file you exported from Data Center

  3. Review the Import Validation Results

  4. Click Perform import

Your Datasources, Queries, Templates, and Converters are now imported into Confluence Cloud.

Check your Datasources. Re-enter Datasource passwords, client secrets, tokens and request header and parameter values where needed, then use Test connection on each Datasource. Datasources whose JDBC URL uses driver properties PocketQuery Cloud does not allow (for example sslfactory, trustStore or file paths) are not imported; adjust the URL and create them manually. REST Datasources must use public hosts and must not rely on redirects. Stored results (snapshots) are shown without scripts until they are refreshed.

Step 4: Configure PocketQuery Administrator and Editor Groups

In your Data Center instance:

  1. Navigate to Administration → PocketQuery → Configuration

  2. Note the configured Administrator and Editor groups

  3. If no groups are configured, you can skip this step in Cloud

In your Cloud instance:

  1. Go to Settings → Apps → PocketQuery

  2. Apply the same Administrator and Editor groups noted earlier

Troubleshooting & Support

If you need help with any of these migration steps, please create a ticket.
We are happy to assist you! 🙂