Installation of the Command-Line Client¶
RAW includes a command-line client (CLI) that allows the execution of queries and other operations on a RAW server from the shell.
Please go to the RAW frontend downloads web page by clicking: Settings >> Install.
there click on the download link for your corresponding operative system (Windows, Linux or MacOS).
To install open a terminal where you downloaded the file and run the following command:
$ pip3 install <downloaded file> --user
For usage instructions, run
Alternatively, it is possible to use virtualenv to install the client in an isolated environment, e.g:
$ virtualenv rawcli $ source rawcli/bin/activate $ pip3 install <downloaded file>
rawcli tool will look for a configuration called
raw.ini in the following locations in order:
<user home directory>/.raw.ini
Alternatively, it is possible to specify a configuration file by using the -c option.
$ rawcli -c <config> ...
The following is an example of a simple configuration, where the RAW server is running on localhost in unsafe mode:
[raw] executor_url = http://localhost:54321 creds_url = http://localhost:54321 auth = basic disable_tls_cert_verification = false [auth_basic] access_token = token
If using a TLS connection (e.g., when the connection between the client and the RAW services
is proxied using TLS), it is possible to disable verification of the TLS certificate by setting
This is useful in cases where the system is using self-signed certificates or certificates that were
issued with a different name than the endpoint used to access the RAW servers.
If RAW is using Auth0 for user management and authentication, use the following configuration (the missing values will be provided).
[raw] executor_url = <EXECUTOR-ADDRESS> creds_url = <CREDS-SERVER-ADDRESS> auth = auth0 [auth0] domain = raw.eu.auth0.com audience = https://just-ask.raw-labs.com auth_type = client_credentials client_id = <AUTH0 CLIENT ID> client_secret = <AUTH0 CLIENT SECRET>