===== APT Repository ====
All tools are distributed via a Debian package repository available at https://repo.unipi.technology/debian/

The APT repository is already preconfigured in our [[files:software:os-images:00-start|official images]].

To install the tools to a clean Debian/Raspberry Pi OS system, follow the steps in the [[https://repo.unipi.technology/debian/index.html|repository index]] 

/* DELETEME
<WRAP group center round box 95%>
{{ :files:img_warning-line_b.png?nolink |}}
<WRAP half column 13%>
{{ :en:hw:08_safety-instructions_pseudo-ISO-7010-info.png?nolink |(!)}}
</WRAP>
<WRAP half column 83%>
**Note:** \\
Development & Testing versions

Our tools are also distributed in testing/development versions. If you wish to install those, find the exact package at https://repo.unipi.technology/debian/pool/test/ and just put it's whole name without the suffix, e.g. _arm64.deb, in the //apt install// command.

Be aware that any package in the testing pool might break things.
</WRAP>
</WRAP>
*/

==== Fixing expired GPG key ===

If you did not update your system packages before the key was switched or you use an obsolete system, you may not be able to update the Unipi packages anymore: 

<code>
Err:4 https://repo.unipi.technology/debian bookworm InRelease
  The following signatures couldn't be verified because the public key is not available: NO_PUBKEY D2055305AB75C32D

...

W: An error occurred during the signature verification. The repository is not updated and the previous index files will be used. GPG error: https://repo.unipi.technology/debian bookworm InRelease: The following signatures couldn't be verified because the public key is not available: NO_PUBKEY D2055305AB75C32D
W: Failed to fetch https://repo.unipi.technology/debian/dists/bookworm/InRelease  The following signatures couldn't be verified because the public key is not available: NO_PUBKEY D2055305AB75C32D
W: Some index files failed to download. They have been ignored, or old ones used instead.
</code>

To fix this issue, you need to make a workaround to update the key:

  * Connect via SSH to your unit and execute following commands:
<code>
sudo su
wget -O - https://repo.unipi.technology/unipi_next.asc > /etc/apt/trusted.gpg.d/unipi_pub.asc
</code>
  * If your unit runs Debian 12 based OS, you should install the package that contains the key and remove the old key:
<code>
apt update && apt install unipi-os-configurator-data unipi-os-configurator -y
rm /etc/apt/trusted.gpg.d/unipi_pub.asc
</code>

These steps updated the OS data package, which contains the GPG key for the Unipi repository.