How to Run Aspose.Cells Cloud Docker Container

Docker technology is designed to automate the deployment of applications by using lightweight containers. Developers can use a Docker container to bundle an application with all of its libraries and dependencies and deploy everything as a single package.

The Aspose.Cells Cloud team has published the Docker container on Docker Hub to facilitate Docker users.

Prerequisites – Ensure Docker Engine ≥ 20.x is installed and that your operating system (Windows 10/Server 2019/2022 or a supported Linux distribution) meets the requirements. An optional license key can be supplied to run in licensed mode.

• Docker Engine ≥ 20.x installed
• Supported OS (Windows 10/Server 2019/2022 or a Linux distribution)
• Optional license key for licensed mode

Container configuration

Required volumes

Linux/macOS alternative – Use /fonts and /data in the container and map them to host directories such as /home/user/fonts and /home/user/data when running the container.

Parameters

If the License parameters are omitted, the app runs in trial mode.

1. Pull Aspose.Cells Cloud Image

# Pull a specific version of the Aspose.Cells Cloud image
docker pull aspose/cells-cloud:25.9.0

# Pull Aspose.Cells Cloud image for Windows Server 2019
docker pull aspose/cells-cloud:ltsc2019.25.9.0

# Pull Aspose.Cells Cloud image for Windows Server 2022
docker pull aspose/cells-cloud:ltsc2022.25.9.0

# Pull Aspose.Cells Cloud image for Windows 11
docker pull aspose/cells-cloud:ltsc2022.25.9.0

Note: To always get the most recent release, you can also pull the latest tag: docker pull aspose/cells-cloud:latest.

2. Configurations for Docker‑Compose Tool

You can write the following configuration in a docker‑compose.yml file:

AsposeCellsCloud:
  image: aspose/cells-cloud:25.9.0
  ports: ["5000:80"]   # host 5000 → container 80
  volumes:
    - "C:/Windows/Fonts:C:/Windows/Fonts"
    - "c:/data:c:/data"
  environment:
    LicensePublicKey: "yourPublicKey"
    LicensePrivateKey: "yourPrivateKey"

Note: The port mapping 5000:80 means that the API will be reachable at http://localhost:5000.

3. Run a Docker container using the command line

docker run \
  -e "LicensePublicKey=yourPublicKey" \
  -e "LicensePrivateKey=yourPrivateKey" \
  -v c:/data:c:/data \
  -v C:/Windows/Fonts:C:/Windows/Fonts \
  -p 5000:80 \
  aspose/cells-cloud:25.9.0

Troubleshooting:

• Port conflict: Ensure that port 5000 on the host is free or change the mapping to an unused port.
• License load failure: Verify that the public and private keys are correctly passed as environment variables or mounted as files.
• Missing fonts: If documents render with incorrect fonts, confirm that the font directory is correctly mounted and contains the required font files.

Related resources:

• API reference | License activation guide | Getting started overview

{
  "@context": "https://schema.org",
  "@type": "HowTo",
  "name": "Run Aspose.Cells Cloud Docker Container",
  "step": [
    {
      "@type": "HowToStep",
      "url": "#1-pull-asposecells-cloud-image",
      "name": "Pull the Docker image",
      "text": "Run `docker pull aspose/cells-cloud:<version>` to download the required image."
    },
    {
      "@type": "HowToStep",
      "url": "#2-configurations-for-docker-compose-tool",
      "name": "Create a docker‑compose file",
      "text": "Define the image, ports, volumes, and license environment variables in `docker‑compose.yml`."
    },
    {
      "@type": "HowToStep",
      "url": "#3-run-a-docker-container-using-the-command-line",
      "name": "Run the container",
      "text": "Execute `docker run` with the appropriate environment variables, volume mounts, and port mapping."
    }
  ]
}