📦 Install Team Assistant

Installing Team Assistant has two steps: first you import the ready-made appliance (.ova) into your virtualization platform, then you go through the setup wizard. The import differs per platform, but the wizard itself is the same everywhere.

⬇ Download the latest Team Assistant (.ova)

Before you start, prepare a virtual machine according to the System requirements and make sure it has internet access — the wizard downloads Docker images during installation.

Step 1 — Import the appliance (.ova)

Import the downloaded .ova file into your virtualization platform. The verified ones are Oracle VirtualBox and Proxmox VE.

Hyper-V is not supported yet. Running on Mac has not been verified.

Oracle VirtualBox

  1. Open VirtualBox and choose File → Import Appliance.
  2. Select the downloaded .ova file and continue.
  3. Review the virtual machine parameters (CPU, RAM, disk) against the system requirements and finish the import.
  4. Start the imported virtual machine.

Proxmox VE

Import the .ova file following the procedure for your Proxmox version and start the created virtual machine.

Exact import steps and screenshots for Proxmox will be added based on the verified procedure for your environment.

Step 2 — Setup wizard

On the first launch of the virtual machine, the setup wizard starts automatically. It guides you through the configuration step by step — the only thing it really needs from you is the application URL (and the network choice). The remaining steps run automatically.

  1. Language selection — choose the interface language (English, Czech, German). The selection is saved for future sessions.
  2. Welcome — an informational intro screen; confirm to continue.
  3. Network configuration — choose how the IP address is obtained:
    • DHCP — the address is assigned automatically,
    • Static IP — you manually enter the IP address, CIDR prefix length (e.g. 24), gateway, and DNS,
    • Keep current — no change.
    The wizard then tests connectivity; on failure it offers to retry or switch between DHCP and static IP.
  4. Application URL — enter the URL through which users will access Team Assistant (e.g. https://tas.example.com). The backend URL defaults to this address with /api appended and can be changed if needed. When you set a new URL, matching (self-signed) certificates are generated automatically.
  5. Download Docker images — the wizard pulls the required TAS service images (requires internet access).
  6. Randomize secrets — cryptographic keys and passwords (JWT, database) are generated automatically. No input required.
  7. Start services — all TAS services start automatically.
  8. Completion — a summary is shown with the application URL and the administrator credentials (username and a randomly generated password).
The administrator password is shown only on the completion screen — write it down. If you lose it, you can generate a new one later from the Maintenance → Reset Admin Password menu.
The wizard can be re-run at any time with the command tas-manager.sh --start-wizzard.

What's next

You now have a running instance of Team Assistant at the URL you set, along with the administrator credentials. The last step before your first sign-in is to obtain a license for your URL — continue to Getting a license.

Frantisek Brych Updated by Frantisek Brych

🖥️ System Requirements

🔑 Get a license

Contact

Syca (opens in a new tab)

Powered by HelpDocs (opens in a new tab)