Docs
  • Solver
  • Models
    • Field Service Routing
    • Employee Shift Scheduling
    • Pick-up and Delivery Routing
  • Platform
Try models
  • Timefold Solver SNAPSHOT
  • Plus/Enterprise Editions
  • Installing Timefold Solver Plus & Enterprise
  • Edit this Page

Timefold Solver SNAPSHOT

    • Introduction
    • PlanningAI Concepts
    • Getting Started
      • Overview
      • Hello World Quick Start Guide
      • Quarkus Quick Start Guide
      • Spring Boot Quick Start Guide
      • Vehicle Routing Quick Start Guide
    • Using Timefold Solver
      • Using Timefold Solver: Overview
      • Configuring Timefold Solver
      • Modeling planning problems
      • Running Timefold Solver
      • Benchmarking and tweaking
    • Constraints and Score
      • Constraints and Score: Overview
      • Score calculation
      • Understanding the score
      • Adjusting constraints at runtime
      • Load balancing and fairness
      • Performance tips and tricks
    • Optimization algorithms
      • Optimization Algorithms: Overview
      • Construction heuristics
      • Local search
      • Exhaustive search
      • Neighborhoods: A new way to define custom moves
      • Move Selector reference
    • Responding to change
    • Integration
    • Design patterns
    • FAQ
    • New and noteworthy
    • Upgrading Timefold Solver
      • Upgrading Timefold Solver: Overview
      • Upgrade from Timefold Solver 1.x to 2.0.0
      • Backwards compatibility
      • Migration Guides
        • Variable Listeners to Custom Shadow Variables
        • Chained planning variable to planning list variable
    • Plus/Enterprise Editions
      • Installing Timefold Solver Plus & Enterprise
      • Performance Improvements
      • Score Analysis
      • Recommendation API
      • Nearby selection
      • Multithreaded solving
      • Partitioned search
      • Constraint profiling
      • Incremental score calculation
      • Multistage Moves
      • Throttling best solution events

Installing Timefold Solver Plus & Enterprise

In order to work with the commercial editions of Timefold Solver, 2 actions need to be taken:

  • Configure a license key;

  • Use the Enterprise artifacts;

License Key

A correctly configured and active license key is required in order for our commercial versions to function.

Obtaining a license key

Contact us through our webform.

Take care not to leak the license file, for example by committing it to a public repository, logging the license file content in logs, or sharing it with unauthorized parties.

Set up your license key

After obtaining your license file (.pem) you can introduce it to your project by one of the following methods:

  • Store the license’s PEM string in the TIMEFOLD_ENTERPRISE_LICENSE environment variable.

  • Store the absolute path to the file in TIMEFOLD_ENTERPRISE_LICENSE_PATH environment variable.

  • Place the file in the user’s home directory.

  • Place the file in the root of your application classpath.

Use the enterprise artifacts

The commercial edition uses different artifacts than our open-source version. These artifacts are available from Maven Central, so no additional repositories need to be configured.

To avoid operational complexity, both Plus and Enterprise editions of Timefold Solver use the enterprise artifacts. Features for your licensed version are enabled based on the provided license key.

Replace references to open-source artifacts by their enterprise counterparts as shown in the following table:

Open source Enterprise

ai.timefold.solver:timefold-solver-bom

ai.timefold.solver.enterprise:timefold-solver-enterprise-bom

ai.timefold.solver:timefold-solver-core

ai.timefold.solver.enterprise:timefold-solver-enterprise-core

ai.timefold.solver:timefold-solver-jackson

ai.timefold.solver.enterprise:timefold-solver-enterprise-jackson

ai.timefold.solver:timefold-solver-quarkus

ai.timefold.solver.enterprise:timefold-solver-enterprise-quarkus

ai.timefold.solver:timefold-solver-quarkus-jackson

ai.timefold.solver.enterprise:timefold-solver-enterprise-quarkus-jackson

ai.timefold.solver:timefold-solver-spring-boot-starter

ai.timefold.solver.enterprise:timefold-solver-enterprise-spring-boot-starter

If you were not using some of these open source artifacts until now, you do not need to add the enterprise counterparts to your project either.

Troubleshooting

After migrating to a commercial edition, most projects work out of the box.

When using the Enterprise version, automatic node sharing is the only feature that places additional restrictions on your code. If you run into unexpected behavior, try disabling that feature or align your code to comply.

If that did not resolve the issue, contact Timefold support.

  • © 2026 Timefold BV
  • Timefold.ai
  • Documentation
  • Changelog
  • Send feedback
  • Privacy
  • Legal
    • Light mode
    • Dark mode
    • System default