Breadcrumbs

Installing TAO Community Edition

This guide explains how to install TAO Community Edition (TAO CE) using Docker.

Container

TAO CE supports deploying its resources as a container using Docker for local development and evaluation.

Prerequisites

  1. Install Docker for your environment by visiting Get Docker.

  2. If you are using Docker Desktop, allocate at least 4 GB of memory.

    • Open Docker Desktop.

    • Go to Settings > Resources > Memory.

    • Adjust the memory allocation if needed.

Retrieve and deploy the TAO CE container

The core TAO CE resources are hosted on http://quay.io/tao-ce/tao-ce:latest . Follow the steps below to pull and deploy the container.

If you have previously installed TAO CE, delete all existing TAO CE containers, volumes, and images from Docker before continuing.

Steps

  1. Download the ZIP archive containing the docker-compose.tao-ce.yaml file from the following URL and unzip it:
    https://gist.github.com/tao-community-edition/5ac924d5021aa2d7d3635064edc0e752/archive/eb21e720043a3278655516ae1e5993ef6ca2e3f4.zip

  2. Open a terminal or command prompt.

  3. Navigate to the folder where the ZIP file was extracted.

  4. Run the following command:

    docker compose -f docker-compose.tao-ce.yaml up -d

  5. Wait for all volumes to be created and all containers to start. When the process completes, the services should be running successfully and you will see something like this:

    docker1.png

Optional hosts configuration (recommended)

Configuring a local host entry simplifies access to TAO CE.

Linux and macOS

  1. Open the /etc/hosts file with administrator privileges.

  2. Add the following line:
    0.0.0.0 community.tao.internal

  3. Save the file.

Windows

  1. Open C:\Windows\System32\drivers\etc\hosts with administrator privileges.

  2. Add the following line:
    127.0.0.1 community.tao.internal

  3. Save the file.

Access TAO CE

  1. Open a web browser.

  2. Go to https://community.tao.internal/.

  3. If a certificate warning appears, proceed to community.tao.internal. In Chrome, for example select Advanced > Proceed:

    docker2.png

  4. Log in using the default credentials:

    • Username: admin

    • Password: password

Immediate action required: change passwords

For security reasons, all default passwords must be changed immediately after installation.

Change the admin password

  1. Click your user avatar in the top-right corner.

  2. Select My account.

  3. Click My user.

  4. Click Change password.

  5. Enter a secure password with at least 8 characters, including at least one lowercase letter, one uppercase letter, and one number or symbol.

  6. Click Save changes.

You may see a warning that your password is not safe enough, despite following the recommended constraints. You can ignore it, as this is a known issue which will be resolved in a future version.

Change test-taker passwords

The following test-taker users are preconfigured: demo01 to demo05. The default password for each user is password.

Steps

  1. From the Portal, click the Users tile.

  2. Locate the users with the Test taker role (demo01 to demo05).

  3. For each user:

    • Open the context menu.

    • Select Edit.

    • Click Change password.

    • Enter a secure password.

    • Click Save changes.

Performance expectations

Concurrent users

The system has been tested with up to 500 concurrent test-takers, using a ramp-up of 25 users per second. All test-takers were able to submit their tests successfully.

Login performance

  • At 500 concurrent test-takers, login delays of up to 1–2 minutes were observed. All users were eventually able to log in.

  • At 200 concurrent test-takers, login delays were acceptable, with a maximum delay of approximately 7 seconds.