Release Trial Install

You can quickly evaluate Digital.ai Release using a free trial license. This guide walks you through installing Release 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 Release features before committing to a full deployment.

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

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 Release container from Docker Hub:

Unix / Linux / macOS

docker run \
  -e "ADMIN_PASSWORD=admin" \
  -e "ACCEPT_EULA=Y" \
  -p 5516:5516 \
  --name xl-release \
  xebialabs/xl-release:24.1.0

Windows

docker run ^
  -e "ADMIN_PASSWORD=admin" ^
  -e "ACCEPT_EULA=Y" ^
  -p 5516:5516 ^
  --name xl-release ^
  xebialabs/xl-release:24.1.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 Release in your browser at http://localhost:5516/.
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
Maximum number of users	10 users

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 17 (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.

Obtain the Trial Software and License

1. Go to the Digital.ai Release 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 Release Licensing.

4. Click the Server Download link at the bottom right of the Release Trial Activation email to download the server archive file.
5. Extract the archive:
   • Create an installation directory such as /opt/xebialabs/xl-release or C:\Program Files\Release (referred to as XL_RELEASE_SERVER_HOME).
   • Extract the Release server archive to XL_RELEASE_SERVER_HOME.

Set up Release

To set up the Release server:

1. Open a terminal or command prompt.

2. Navigate to the XL_RELEASE_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 agree with the following settings for XL Release Server?

     Answer yes to finish setup.

Start Release

To start the Release server:

1. Open a terminal or command prompt.

2. Navigate to the XL_RELEASE_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 Release. If not, the default is http://localhost:5516/.

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 Release 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
Maximum number of users	100 users

Next Steps

Get Started With Release 24.1