Truetask Admin

Appearance

Updates ​

Truetask is updated using the built-in update script or by re-running the installer. Updates replace the application code while preserving your database, uploads, and configuration.

Your license includes an upgrade grace period (typically one year from purchase). During this window, all updates are available. After it expires, you can continue using your current version indefinitely or purchase an upgrade to extend the window. See Licensing for details.

How updates work ​

Your Truetask installation separates application code (source/) from persistent data (data/). During an update:

  1. The current .env is backed up to the data directory
  2. The source/ directory is replaced entirely with the new release
  3. The .env is restored
  4. Services are rebuilt and restarted
  5. Database migrations run automatically on startup

Your database, uploaded files, and configuration are never touched by the update process.

Using the update script ​

bash
cd truetask
./truetask-update.sh

The script will:

  • Authenticate with the Client Portal
  • Check for a newer release
  • Show the available version and ask for confirmation
  • Download, extract, and restart services

If your portal credentials are saved in config.ini, the script uses them automatically. Otherwise, it prompts for email and password.

Using the installer ​

You can also re-run the installer. It detects the existing installation and enters update mode:

bash
bash <(curl -sSL https://portal.truetask.dev/install.sh)

This is functionally identical to the update script.

Offline updates ​

For servers without internet access:

  1. Download the release ZIP from the Client Portal on a machine with internet
  2. Transfer the ZIP to the server
  3. Stop services: ./truetask-stop.sh
  4. Back up the .env: cp source/.env data/.env
  5. Replace the source directory:
bash
rm -rf source
mkdir source
unzip truetask-vX.Y.Z.zip -d source/
  1. Restore the .env: cp data/.env source/.env
  2. Start services: ./truetask-start.sh

Version tracking ​

The current version is stored in source/VERSION and config.ini. Check it with:

bash
./truetask-status.sh

Or directly:

bash
cat source/VERSION

Rollback ​

If an update causes issues:

  1. Stop services: ./truetask-stop.sh
  2. Download the previous release ZIP from the Client Portal
  3. Follow the offline update procedure with the older version
  4. Start services: ./truetask-start.sh

WARNING

Database migrations are forward-only. Rolling back to a much older version may cause compatibility issues if the database schema has changed significantly. Always create a backup before updating.