Chapter 7. Appendix: Modifying the configuration of the command-line assistant

Procedure

1. Access the proxy configuration by opening the /etc/xdg/command-line-assistant/config.toml configuration file.

2. Locate and change the following block in the config.toml file :

   # Backend settings for communicating with the external API.
   [backend]
   ...
   # proxies = { http = "http://example-host:8002", https = "https://example-host:8002" }

   Copy to Clipboard

3. Uncomment the proxies key and define your http or https proxy host:

   [backend]
   …
   # For a https proxy host
   proxies = { https = "https://<your-https-proxy-host:1234>"}

   Copy to Clipboard

4. After making the changes, restart clad for the changes to be effective:

   $ sudo systemctl restart clad

   Copy to Clipboard
   Note

   You can use the http value and https key control if the http or https traffic from clad is routed to the specified proxy. However, the protocol does not influence the proxy type selection, and you can have a configuration that uses http proxy for https traffic. For example:

   https = "http://<your-https-proxy-host:1234>"

   Copy to Clipboard

Procedure

1. Install the database of your choice:

   • To install MySQL, enter:

     # dnf install python3-PyMySQL

     Copy to Clipboard

   • To install PostgreSQL, enter:

     # dnf install python3-psycopg2

     Copy to Clipboard
2. Access your database configuration file at /etc/xdg/command-line-assistant/config.toml.

3. Locate and comment out the default configuration. For example:

    [database]
       # type = "sqlite"
       # connection_string = "/var/lib/command-line-assistant/history.db"

   Copy to Clipboard

4. Configure the database of your choice. The following information is also available in /etc/xdg/command-line-assistant/config.toml.

   1. Set the database type, where <db_type> can be mysql or postgresql.

   2. Set the database details.

       type = <db_type>
       host = "<hostname_or_ip_address>"
       port = "5432"
       username = "<database_user_name>"
       password = "<password>"
       database = "<database_name>"

      Copy to Clipboard

5. After changing the database type, restart the clad daemon to apply the changes:

   $ sudo systemctl restart clad

   Copy to Clipboard

Procedure

1. Access your database configuration file at /etc/xdg/command-line-assistant/config.toml.

2. Remove the username and password parameters from the [database] section, for example:

   [database]
   type = "postgresql"
   host = "localhost"
   port = "5432"
   database = "history"

   Copy to Clipboard
   Note

   If you leave the username and password in the configuration file, these credentials take precedence over the systemd-creds tool.

3. Generate encrypted credentials for your username or password. The following example uses systemd-ask-password commands. The name must follow the schema of database-username and database-password, otherwise, clad does not load the credentials properly.

   1. To generate an encrypted username, run the following command:

      $ systemd-ask-password -n | ( echo "[Service]" && systemd-creds encrypt --name=<database-username> -p - - ) >/etc/systemd/system/clad.service.d/<username>.conf

      Copy to Clipboard

   2. To generate an encrypted password, enter:

      $ systemd-ask-password -n | ( echo "[Service]" && systemd-creds encrypt --name=<database-password> -p - - ) >/etc/systemd/system/clad.service.d/<password>.conf

      Copy to Clipboard

4. After updating the database credentials, reload systemd and restart the clad daemon to apply the changes:

   $ sudo systemctl restart clad

   Copy to Clipboard