Command line tools

From TempusServa wiki
Jump to navigation Jump to search

A new version of the CLI was released on 21. december 2023.

If you are looking for the old CLI you can find the documentation here.

Compatibility

The tools are compatible with the following distributions.

  • Amazon Linux, version 2 and 2023
  • Debian, version 11 and 12
  • CentOS, version 8 and 9

The script will check to see if it is running on one of these OSes and stop executing if not.

Usage information

The Tempus Serva Linux script tools are open source (LGPL), and you are free to use and modify them however you see fit. The tools are defined by one python3 script and a single json file that stores the config.

As the tools themselves are subject to semiautomatic upgrades, we strongly recommend that you keep backups of files you have modified. Future versions of the scripts are not guaranteed to be compatible, with earlier versions or your own modifications.

Installing the tool

To install the tools, run:

wget -qO - https://builds.tsnocode.com/helpers/install | bash

This will check compatibility and install the required plugins.

To use the tool, execute ts.

On first execution the tool will ask a couple of questions.

If you choose to run java 8, alpha and beta is the same release, previously known as nightly.

Tool reference

To get the full list of commands, and a description, run ts --help.

quick-install

Installs all the required software to run TS NoCode Platform, a default webapp named 'app' and a redirect from root to 'app'.

It will not ask for anything, but uses default values.

install

Installs all the required software to run TS NoCode Platform.

It will ask questions about optional stuff.

install-app

Will install a new TS NoCode Platform webapp. It ask what release to install from and what name the webapp should be deployed under, if that webapp exists it will ask if you would like to upgrade that installation instead.

upgrade-app

Will upgrade an existing TS NoCode Platform webapp. It will ask what release to upgrade from and what name the webapp should be deployed under, if that webapp doesn't exist it will do nothing.

set-admin-password

Will set the admin password for an existing TS NoCode Platform webapp. Will ask what webapp to modify and what the password should be set to.

install-ssl

Will install all dependencies that are needed to setup a LetsEncrypt SSL certificate. Will ask if SSL should be setup once the install completes.

setup-ssl

Will ask about domain(s) and contact-email, request and install an SSL certificate and setup auto-renewal.

Quick install

To quick-install the tool and a webapp run this

wget -qO - https://builds.tsnocode.com/helpers/install | bash && ts quick-install

If you also want to setup SSL, run this

wget -qO - https://builds.tsnocode.com/helpers/install | bash && ts quick-install && ts install-ssl

Removing the tools

Remove the two files, eg by running:

sudo rm /usr/bin/{ts,tsconfig.json}