# Installing the Teamscale Server

This guide will show you how to get started with Teamscale in five simple steps:

Detailed Guides

This guide only describes the basics needed to get Teamscale up and running. For detailed information on the setup process, please refer to Server Administration.

# Downloading Teamscale

You can download Teamscale's latest version from our website.

# Getting Your Evaluation License

To use Teamscale, you will need a valid license file (teamscale.license). If you don't have one yet, you can get a free evaluation license.

Free for Academic Users

Academic users, including students and research groups, can get a free permanent license for Teamscale. Please contact sales@teamscale.com for details.

# Running Teamscale

  1. Unzip Teamscale into a directory of your choice.

  2. Place the license file teamscale.license in the config directory.

  3. Run Teamscale

    • On Windows: Run the file teamscale.bat by double clicking it.
    • On Linux & macOS: Run the file teamscale.sh by executing ./teamscale.sh.
  4. Visit http://localhost:8080 in your web browser:

    Teamscale's Login Screen

Running with Docker

For instructions on running Teamscale with Docker, please see Teamscale's Docker Hub page.

Install as Service

For production use, we recommend to install Teamscale as system service under either Linux or Windows.

# Logging In

Enter the default admin credentials:

  • User: admin
  • Password: admin

Change Default Password

For security reasons, change your password before making your Teamscale instance available to others.

# Adding a Project

Now you are all set to add your first project to Teamscale. This is described in a follow-up article.