Deploy Trial Install

You can quickly evaluate Digital.ai Deploy using a free trial license. This guide walks you through installing Deploy either as a Docker container or directly on your system (JVM-based install). Both methods are intended for short-term, non-production use and provide a simple way to explore Deploy features before committing to a full deployment.

For a complete list of supported platforms, databases, browsers, and advanced requirements, see Requirements for Installing Deploy.

Trial Installation Using Docker

To get started with a Docker-based trial installation, ensure your environment meets the following prerequisites:

Prerequisites

• Docker: Must be installed and running. See Get Docker.
• Operating System: Windows, Mac OS, Ubuntu, or RHEL.
• Hardware: Minimum 8GB RAM and quad-core CPU recommended.

1. Start Docker.
2. Open a terminal or command prompt.
3. Run the following command to download and start the Deploy container from Docker Hub:

Unix / Linux / macOS

docker run \
  -e ADMIN_PASSWORD=admin \
  -e ACCEPT_EULA=Y \
  -p 4516:4516 \
  --name xl-deploy \
  xebialabs/xl-deploy:22.3.0

Windows

docker run ^
  -e ADMIN_PASSWORD=admin ^
  -e ACCEPT_EULA=Y ^
  -p 4516:4516 ^
  --name xl-deploy ^
  xebialabs/xl-deploy:22.3.0

tip

The ADMIN_PASSWORD environment variable is set to admin for demonstration. Change it to a password of your choice if needed.

4. Once the container starts, access Deploy in your browser at http://localhost:4516/.
5. When prompted for login, use:
   • Username: admin
   • Password: admin (or the value you set for ADMIN_PASSWORD)

Docker Trial License Information

note

Docker images use a 7-day trial license by default.

Property	Value
License Validity	7 Days
Support Policy	Community Support
Licensed # Of Satellites	0

Trial Installation Using JVM

Before proceeding with a JVM-based trial installation, make sure your environment satisfies these prerequisites:

Prerequisites

• Java Development Kit (JDK): JDK 11 (Oracle JDK or OpenJDK) must be installed and set as the default.
• Operating System: Windows, Mac OS, Ubuntu, or RHEL.
• Hardware: Minimum 8GB RAM and quad-core CPU recommended.
• Disk Space: At least 100GB free for default installation with embedded database.
• Database: PostgreSQL (recommended, see PostgreSQL Docker installation).

Obtain the Trial Software and License

1. Go to the Digital.ai Deploy Trial Page.
2. Enter your details and click Request Free Trial.
3. You will receive a trial license key and server installation link by email.
   tip

   If you can't find the email, check your spam folder or contact Support. For more on licensing and upgrades, see Deploy Licensing.

4. Download the server archive file by clicking Server Download at bottom right of the Deploy Trial Activation email.
5. Extract the archive:
   • Create an installation directory such as /opt/xebialabs/xl-deploy or C:\Program Files\Deploy (referred to as XL_DEPLOY_SERVER_HOME).
   • Extract the Deploy server archive to XL_DEPLOY_SERVER_HOME.
6. Download the PostgreSQL JDBC driver and copy the JAR file to XL_DEPLOY_SERVER_HOME/lib.

Install PostgreSQL Using Docker

Run the following command in your terminal:

Unix / Linux / macOS

docker run -d \
  --name postgres \
  -p 5432:5432 \
  -e POSTGRES_USER=postgres \
  -e POSTGRES_PASSWORD=demo \
  postgres:14.3 \
  postgres

Windows

docker run -d ^
  --name postgres ^
  -p 5432:5432 ^
  -e POSTGRES_USER=postgres ^
  -e POSTGRES_PASSWORD=demo ^
  postgres:14.3 ^
  postgres

See command breakdown

Option	Description
-d	Run container in detached mode
--name postgres	Name the container postgres
-p 5432:5432	Map port 5432 on the host to port 5432 in the container
-e POSTGRES_USER=postgres	Set the default user
-e POSTGRES_PASSWORD=demo	Set the password for the user
postgres:16	Use the official PostgreSQL 16 image
postgres	(Optional) Entrypoint command, explicitly tells the container to start PostgreSQL

Once the container is running, you will need the JDBC URL to connect Deploy to your PostgreSQL database during the setup process. Keep this URL handy, as you will be prompted to enter it when configuring the database connection for Deploy.

For example:

jdbc:postgresql://localhost:5432/postgres

This JDBC URL is used by Deploy to establish a connection to your PostgreSQL instance. Each part of the URL has a specific meaning:

See JDBC URL breakdown

Part	Meaning
jdbc	Protocol for Java database connections.
postgresql	Database type; determines JDBC driver (org.postgresql.Driver).
//localhost	Hostname where PostgreSQL is running (localhost or mapped Docker port).
:5432	Port number for PostgreSQL (default: 5432).
/postgres	Database name (default: postgres).

Set up Deploy

To set up the Deploy server:

1. Open a terminal or command prompt.

2. Navigate to the XL_DEPLOY_SERVER_HOME/bin directory.

3. Run the setup command for your OS:

   Operating System	Command
   Microsoft Windows	run.cmd -setup
   Unix-based Systems	run.sh -setup
   Mac OS	./run.sh -setup

4. During setup, respond to prompts as follows:

   • Do you want to use the simple setup?

     Type yes for a guided configuration.

     tip

     For advanced/manual setup, see Choose an Installation Type.

   • Provide a password for the admin user:

     Enter a password with at least 6 characters.

   • Generate an encryption key?

     For trial, enter no.

   • Do you want to configure the database connection in this wizard? (default: no)

     Enter yes.

     • What is the JDBC URL to use?:

       jdbc:postgresql://localhost:5432/postgres

     • What is the JDBC driver name? [org.postgresql.Driver]:

       Press Enter.

     • What is the JDBC username?:

       Enter your PostgreSQL username.

     • What is the JDBC password?:

       Enter your PostgreSQL password.

   • Do you agree with the following settings for XL Deploy Server?

     Answer yes to finish setup.

Start Deploy

To start the Deploy server:

1. Open a terminal or command prompt.

2. Navigate to the XL_DEPLOY_SERVER_HOME/bin directory.

3. Start the server using the command for your OS:

   Operating System	Command
   Microsoft Windows	run.cmd
   Unix-based Systems	run.sh
   Mac OS	./run.sh

4. Once the server starts, the installer displays the URL where you can access Deploy. If not, the default is http://localhost:4516/.

Login Credentials

When prompted to login, use:

• Username: admin
• Password: (set during setup)

Install the License

When prompted for a license key:

1. Check your email for the Deploy trial license key, copy and paste it into the text box.
2. Click Install License.

JVM Trial License Information

Property	Value
License Validity	30 Days
Support Policy	Technical Support
Licensed # Of Satellites	1

Next Steps

Get Started With Deploy