How Do You Install IronPDF for Python?

Before applying a license key, IronPDF must be present in the Python environment. Install it using pip:

//:path=install.sh
:ProductInstall

//:path=install.sh
:ProductInstall

Once pip completes, the ironpdf package is available for import in any script within the active environment. No additional configuration is needed beyond the .NET runtime dependency.

How Do You Apply an IronPDF License Key in Python?

Set the LicenseKey attribute on the License class at the very beginning of your script — before calling any IronPDF API. Placing the key assignment after PDF operations will have no effect on those calls.

//:path=apply_license.py
from ironpdf import License

# Apply your license key before any PDF operation
License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"

//:path=apply_license.py
from ironpdf import License

# Apply your license key before any PDF operation
License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"

A free 30-day trial key is available if you want to evaluate the full feature set before purchasing. Trial keys follow the same assignment syntax. To acquire a full license, visit the IronPDF Python licensing page.

How Do You Verify and Validate an IronPDF License Key?

Two members of the License class serve different verification purposes: IsLicensed checks whether a valid key is currently active in the runtime, while IsValidLicense() checks whether a specific key string is structurally valid and recognized by IronPDF's licensing server.

//:path=check_is_licensed.py
from ironpdf import License

# Apply license before checking
License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"

# Returns True if a valid key is active in this session
is_licensed = License.IsLicensed
print(f"Runtime is licensed: {is_licensed}")

//:path=check_is_licensed.py
from ironpdf import License

# Apply license before checking
License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"

# Returns True if a valid key is active in this session
is_licensed = License.IsLicensed
print(f"Runtime is licensed: {is_licensed}")

//:path=validate_license_key.py
from ironpdf import License

# Validate a key string before applying it
key_to_check = "IRONPDF-MYLICENSE-KEY-1EF01"
is_valid = License.IsValidLicense(key_to_check)

if is_valid:
    License.LicenseKey = key_to_check
    print("License key is valid and has been applied.")
else:
    print("License key is invalid. Check the key and try again.")

//:path=validate_license_key.py
from ironpdf import License

# Validate a key string before applying it
key_to_check = "IRONPDF-MYLICENSE-KEY-1EF01"
is_valid = License.IsValidLicense(key_to_check)

if is_valid:
    License.LicenseKey = key_to_check
    print("License key is valid and has been applied.")
else:
    print("License key is invalid. Check the key and try again.")

What Happens After Applying a License in a Deployed Application?

For development and local testing, the license key takes effect immediately in the running process. No rebuild or republish is required. For production deployments and live applications, the recommended practice is to clean and republish the application after updating the license key to prevent stale environment state from causing unexpected behavior.

Store the license key in an environment variable or a secrets manager rather than hardcoding it in source code. Read the key at application startup and assign it before the first PDF operation:

//:path=license_from_env.py
import os
from ironpdf import License

# Read the license key from an environment variable
license_key = os.environ.get("IRONPDF_LICENSE_KEY", "")

if license_key:
    License.LicenseKey = license_key
else:
    print("Warning: IRONPDF_LICENSE_KEY is not set. Running in trial mode.")

//:path=license_from_env.py
import os
from ironpdf import License

# Read the license key from an environment variable
license_key = os.environ.get("IRONPDF_LICENSE_KEY", "")

if license_key:
    License.LicenseKey = license_key
else:
    print("Warning: IRONPDF_LICENSE_KEY is not set. Running in trial mode.")

This pattern keeps sensitive credentials out of version control and works across development, staging, and production environments without code changes.

What Are the Next Steps?

With a valid license key applied, IronPDF for Python is ready for full production use. Consider these resources to move forward:

• Get Started with IronPDF for Python — The official getting-started tutorial walks through HTML-to-PDF conversion, PDF manipulation, and common document workflows from scratch.
• IronPDF for Python Code Examples — A library of ready-to-run Python examples covering PDF generation, merging, stamping, form handling, and more.
• Purchase a Full License or Start a Free Trial — Obtain a trial license key for 30-day evaluation or purchase a production license to deploy without restrictions.