KLIMATE FOR LINUX - GETTING STARTED
===================================

Version: 26.0725
Platform: 64-bit Intel/AMD Linux (x86_64/amd64)


1. CHOOSE THE CORRECT PACKAGE
-----------------------------

Use the Debian package on Ubuntu, Debian, Linux Mint, and related systems:

  klimate_26.0725_amd64.deb

Use the RPM package on Fedora, RHEL, Rocky Linux, AlmaLinux, and related systems:

  klimate-26.0725-1.x86_64.rpm

Klimate requires a Linux distribution that uses systemd. You also need root
access, normally through the sudo command.

To confirm that your computer has the correct processor architecture, run:

  uname -m

The result should be:

  x86_64


2. VERIFY THE DOWNLOAD (RECOMMENDED)
------------------------------------

Open a terminal in the directory containing the downloaded files and run:

  sha256sum -c Klimate-26.0725-linux-amd64-SHA256SUMS.txt

Each verified package should report "OK".


3. INSTALL KLIMATE
------------------

Ubuntu, Debian, Linux Mint, and related systems:

  sudo apt install ./klimate_26.0725_amd64.deb

Fedora, RHEL, Rocky Linux, AlmaLinux, and related systems:

  sudo dnf install ./klimate-26.0725-1.x86_64.rpm

The installer adds and starts the Klimate background service. It also configures
the service to start automatically when the computer boots and to restart if it
fails.


4. CHECK KLIMATE
----------------

Give the service a moment to start, then run:

  klimate status

This displays information such as the service state, registration state, cloud
connection, serial number, version, and uptime.

You can also inspect the system service directly:

  sudo systemctl status klimate-agent --no-pager


5. MANAGE THE SERVICE
---------------------

Restart the service:

  sudo systemctl restart klimate-agent

Stop the service:

  sudo systemctl stop klimate-agent

Start the service:

  sudo systemctl start klimate-agent

Enable automatic startup:

  sudo systemctl enable klimate-agent


6. VIEW LOGS
------------

View the latest Klimate application log entries:

  sudo tail -n 100 /var/log/klimate/agent.log

View recent systemd service messages:

  sudo journalctl -u klimate-agent --no-pager -n 100


7. TROUBLESHOOTING
------------------

If "klimate status" reports that the Klimate service is unavailable:

  sudo systemctl restart klimate-agent
  klimate status

If the problem continues, inspect the service and logs:

  sudo systemctl status klimate-agent --no-pager
  sudo tail -n 100 /var/log/klimate/agent.log
  sudo journalctl -u klimate-agent --no-pager -n 100


8. UPGRADE KLIMATE
------------------

Download the newer package and install it over the existing version.

For a newer Debian package:

  sudo apt install ./NAME-OF-NEW-PACKAGE.deb

For a newer RPM package:

  sudo dnf upgrade ./NAME-OF-NEW-PACKAGE.rpm

The service is restarted during the upgrade. Existing Klimate data is retained.


9. UNINSTALL KLIMATE
--------------------

Ubuntu, Debian, Linux Mint, and related systems:

  sudo apt remove klimate

Fedora, RHEL, Rocky Linux, AlmaLinux, and related systems:

  sudo dnf remove klimate

Klimate state and logs are retained in these directories after uninstalling:

  /var/lib/klimate
  /var/log/klimate

Delete those directories manually only if you intentionally want to erase the
Klimate identity, stored data, and logs.


For additional information, visit:

  https://klimate.app
