Installation Guide

This guide will walk you through setting up Fuabioo’s APT repository on your system and installing packages.

Repository Setup

Install the GPG key for security

curl -fsSL https://apt.fuabioo.com/public.gpg | sudo tee /usr/share/keyrings/apt.fuabioo.gpg > /dev/null

Add the repository to your APT sources for your specific architecture

echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/apt.fuabioo.gpg] https://apt.fuabioo.com stable main" | sudo tee /etc/apt/sources.list.d/apt.fuabioo.list

Update your package list
Terminal window
```
sudo apt update
```
(Optional) Verify installation by installing a test package
Terminal window
```
sudo apt install dontrm
```
Terminal window
```
dontrm version
```

Installing Packages

Once the repository is set up, you can install any available package:

sudo apt install <package-name>

Examples:

sudo apt install dontrm - Install safe rm alternative
sudo apt install fastfetch - Install system info tool
sudo apt install buf-fmt-stdin - Install protocol buffer formatter

Package Management

Get Package Information

View detailed information about any package before installing:

apt show <package-name>

List Available Packages

See all packages available from this repository:

apt list | grep fuabioo

List Installed Packages

See which packages from this repository are currently installed:

apt list --installed | grep fuabioo

Update Packages

Keep your packages up to date:

sudo apt update && sudo apt upgrade

Remove Packages

Uninstall packages you no longer need:

sudo apt remove <package-name>

System Requirements

Operating System: Debian-based Linux distributions (Ubuntu, Debian, etc.)
Minimum Ubuntu Version: Ubuntu 20.04 LTS (Focal Fossa) or newer
Supported Architectures: amd64, arm64, armhf, armv6, armv7
Privileges: sudo access required for installation

Compatibility Notes

This repository requires Ubuntu 20.04 LTS or newer due to:

Modern GPG key handling (signed-by parameter)
HTTPS certificate verification requirements
Updated APT security features

System Compatibility:

✅ Ubuntu 20.04 LTS+ - Fully supported
✅ Debian 11 (Bullseye)+ - Fully supported
⚠️ Debian 10 (Buster) - May require manual updates
❌ Ubuntu 18.04 or older - Not supported (GPG keyring issues)
❌ Debian 9 or older - Not supported

If you’re using an older system, consider upgrading to a supported version for the best experience.

Troubleshooting

GPG Key Issues

If you encounter GPG verification errors:

# Remove old key if it exists
sudo rm -f /usr/share/keyrings/apt.fuabioo.gpg

# Re-download the key
curl -fsSL https://apt.fuabioo.com/public.gpg | sudo tee /usr/share/keyrings/apt.fuabioo.gpg > /dev/null

Repository Connection Issues

If you can’t connect to the repository:

# Test connectivity
curl -I https://apt.fuabioo.com

# Check repository configuration
cat /etc/apt/sources.list.d/apt.fuabioo.list

Package Not Found

If a package isn’t found after setup:

# Force refresh package lists
sudo apt update --allow-releaseinfo-change

Older Ubuntu/Debian Versions

If you’re running Ubuntu 18.04 or older and encounter GPG keyring errors:

Option 1: Upgrade to a supported version (Recommended)

# Check your current version
lsb_release -a

# For Ubuntu systems, upgrade to 20.04 LTS or newer
sudo do-release-upgrade

Option 2: Manual workaround for legacy systems

# Use the legacy trusted.gpg method (less secure)
curl -fsSL https://apt.fuabioo.com/public.gpg | sudo apt-key add -
echo "deb [arch=$(dpkg --print-architecture)] https://apt.fuabioo.com stable main" | sudo tee /etc/apt/sources.list.d/apt.fuabioo.list
sudo apt update

Note: The legacy method bypasses modern security features and is not recommended for production systems.

Uninstalling the Repository

To completely remove the repository from your system:

Remove all installed packages (optional):

sudo apt remove dontrm fastfetch buf-fmt-stdin php-cs-fixer-stdin stella

Remove repository configuration:

sudo rm /etc/apt/sources.list.d/apt.fuabioo.list

Remove GPG key:

sudo rm /usr/share/keyrings/apt.fuabioo.gpg

Update package lists:
Terminal window
```
sudo apt update
```

Ready to explore packages? Check out the Package Catalogue to see all available tools!