Aspose.Cells Cloud Docker Operation Manual
Aspose.Cells Cloud is a cloud‑based spreadsheet processing service that supports the creation, editing, conversion, and manipulation of files in formats such as Excel. It can be quickly set up as an independent service environment through Docker deployment, simplifying dependency management and cross‑platform deployment processes.
This manual provides a detailed introduction to the complete operational steps—from environment preparation to service verification.
Environment Preparation
Before deploying the Aspose.Cells Cloud Docker container, ensure that the local environment meets the following dependency requirements to avoid deployment failures due to missing components.
Basic dependency components
-
Docker Engine: The container runtime core engine responsible for creating and managing containers. Minimum version requirement is 18.09.0.
-
Operating Systems: Mainstream operating systems that support Docker
Operating System Type Version Windows Windows 10/11 Windows Server 2016 / 2019 / 2022 Linux CentOS 7+ / Ubuntu 20.04+ -
Hardware resources: Ensure the service runs smoothly to avoid crashes due to insufficient resources.
- CPU: 2 cores or more.
- Memory: 4 GB or more.
- Disk: 10 GB of free space.
Key prerequisite conditions
- Aspose License: Register for an Aspose official account to obtain a valid license (you can apply for a trial version or purchase a commercial version). Without a license, service functionality may be restricted. Please refer to the License page for more details.
- Network Connectivity: Ensure that the deployment environment can access Docker Hub (to pull images).
Obtain the Aspose.Cells Cloud Docker image
The Aspose.Cells Cloud image is hosted on Docker Hub and can be pulled directly with the docker pull command, without the need for manual building.
# Linux
docker pull aspose/cells-cloud:linux.22.2.0
docker pull aspose/cells-cloud:latest
# Windows
docker pull aspose/cells-cloud:ltsc2019.25.9.0
docker pull aspose/cells-cloud:ltsc2022.25.9.0
Run Aspose.Cells Cloud Docker Container
Run Parameters
| Name | Description | Remark |
|---|---|---|
| LicensePublicKey | Set the public key of the license when using the Metered billing mode. | Only effective when the Metered billing mode is adopted. |
| LicensePrivateKey | Set the private key of the license when using the Metered billing mode. | Only effective when the Metered billing mode is adopted. |
| storagesCredentialsFilePath | Path to the storage configuration file. Default file is ./storageResource.json. |
|
| LicenseFile | Set the license file when using the LicenseFile billing mode. | Only effective when the LicenseFile billing mode is adopted. |
| AccessToken | Token for accessing the API. | If empty, no token verification is required. |
Run Command
Running the container in trial mode is as simple as this:
docker run -p 47900:5000 aspose/cells-cloud:ltsc2022.22.9.0
For full‑featured execution, obtain a Metered license and mount a host folder for file storage. Here is how the run command would look in this case:
API Reference – Aspose.Cells Cloud Docker
<https://hostname:port/swagger><https://hostname:port/swagger/ui/index.html>
Expose Port
| Port | Description | Required |
|---|---|---|
| 5000 | Folder with fonts used to render documents | true |
Required volumes
| Mount path in container | Description | Required | Remark |
|---|---|---|---|
| C:\fonts | Folder with fonts used to render documents | false | Resolves spreadsheet/Excel issues caused by missing fonts. |
| C:\data | File storage folder | false | Increases storage space for easier file management and access. |