Getting Started with QuarkXPress Server 2025

Using Azure Blob Storage as a document pool in QuarkXPress Server

This section describes the steps necessary to use Azure Blob Storage as a docpool in QuarkXPress Server.

We recommend installing/using QuarkXPress Server on Azure VM to use Blob Storage as document pool for QuarkXPress Server.

 

Define Connection String

 

To get the connection string for Blob Storage on the Azure portal, follow these steps:

  1. Log in to Azure Portal: Navigate to the Azure portal and sign in with your credentials.

  2. Navigate to Storage Account: Go to your specific storage account.

  3. Access Keys: In the left-hand menu, under the "Security + networking" section, click on "Access keys."

  4. Copy Connection String: You will see the connection strings for both primary and secondary access keys. Click the "Copy" button next to the connection string you need.

  5. Paste Connection String: Paste the connection string next to the "qxps-blob-connection-string" entry in the "AZURE-BLOB.properties" file, located in the conf folder of your QXPS installation directory.

     

Get the Blob Storage path for docpool

 

To get the URL of your container from the Azure portal, follow these steps:

  1. Log in to Azure Portal: Navigate to the Azure portal and sign in with your credentials.

  2. Navigate to Storage Account: Go to your specific storage account.

  3. Access Containers: In the left-hand menu, under the "Data storage" section, click on "Containers."

  4. Select Your Container: Click on the container for which you want the URL.

  5. Copy URL: In the container's overview, you will see the URL under "Settings > Properties". Click the "Copy" button next to the URL to copy it.

Register Azure Blob Storage as a Docpool in QuarkXPress Server

  1. Open QuarkXPress Server's web-based Admin UI.

  2. Go to Administration > Preferences > General.

  3. In the Document Root Folder, specify the docpool URL:

    blobs://qxps.blob.core.windows.net/qxps/docpool

    Change "https" to "blobs" in the copied URL of the container and create a "docpool" folder within the container.
Alternately, you can set the document pool folder by using the following request: http://localhost:8080/setprefs?DocumentRootFolder=blobs://qxps.blob.core.windows.net/qxps/docpool

Font Management

Improved font management in multi-tenancy deployments for customer specific fonts. Fonts of different customers can be managed by creating customer specific folder (tenant id) on blob storage under "fonts" folder. 

Fonts folder should be created parallel to the document pool (as mentioned above) folder within the container.

After managing fonts on blob storage, you can utilize either of two different paths to access tenant-specific fonts:

  1. Azure to Local Fonts: Download all fonts from Azure to local disk once and use these fonts for your requests.

  2. Azure Fonts: Use the Azure fonts with your requests.

Azure to Local Fonts

Whenever fonts are updated on Azure, you can download them to your local disk using the following request: http://localhost:8080/download/fonts?fontsuri=fonts

After downloading, you can send the following request to use these fonts: http://localhost:8080/pdf/template.qxp?modify=file:mod.xml&tenantid=TENANT_ID&transactionuuid=TRANSACTION_UUID

Fonts will be copied parallel to renderer's log folder.

Azure Fonts

You can use the following request to use the fonts directly from Azure: http://localhost:8080/pdf/template.qxp?modify=file:mod.xml&fontsuri=file:fonts&tenantid=TENANT_ID&transactionuuid=TRANSACTION_UUID