Run Document Processing on Your Own Infrastructure

⚡ Quick Start

Choose the setup that fits your workflow. Both options take only a few steps.

.NET 9 (fastest way)

If you already have .NET installed, this is the quickest way to get started.

1. Download the self-host package
2. Extract the archive
3. Run:

dotnet Documentize.SelfHost.dll

Then open http://localhost in your browser.

Docker

Prefer containers? Use the included Dockerfile to run Documentize anywhere.

1. Download the Docker package
2. Build the image:

docker build -t documentize .

Run the container:

docker run -p 80:80 documentize

Then open http://localhost.

🧩 Requirements

Minimal requirements depending on your setup:

• .NET 9 Runtime for direct execution
• Docker for containerized setup

⚙️ More Details

The self-host version is built as a standard ASP.NET Core application, so it behaves exactly like any modern .NET web API.

• Runs locally or on any server
• Default Docker port: 80
• No external services required
• Suitable for internal tools or production use

🔑 Licensing

Without a license the API runs in Trial Mode — output files may contain evaluation watermarks. Apply a license to enable full, watermark-free processing.

Option 1 — Environment variable

Base64-encode your .lic file and pass it as an environment variable before starting:

# Linux / macOS
export ASPOSE_PDF_LICENSE=$(base64 -w 0 Aspose.Pdf.lic)
dotnet Documentize.SelfHost.dll

# Docker
docker run -p 80:80 \
  -e ASPOSE_PDF_LICENSE=$(base64 -w 0 Aspose.Pdf.lic) \
  documentize

Option 2 — Upload via API

POST the .lic file to your running instance at any time. The license is saved to disk and re-applied automatically on the next restart.

curl -X POST http://localhost/webapi/license \
  -F "license=@Aspose.Pdf.lic"

Or use the Upload License widget in the sidebar — enter your instance URL, pick the file, and click Upload.

Check the current license status at any time:

GET http://localhost/webapi/license
# { "licensed": true }