From 85f0c47f328e8c07df151f653846890ca5c3752a Mon Sep 17 00:00:00 2001 From: Mike Sul Date: Thu, 19 Feb 2026 15:21:02 +0100 Subject: [PATCH 1/2] docs: add info about installation from APT Signed-off-by: Mike Sul --- README.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/README.md b/README.md index 673b741..e3764f4 100644 --- a/README.md +++ b/README.md @@ -9,6 +9,35 @@ This includes tasks such as installation, running, stopping, etc. ## Installation +### Install From APT (Debian/Ubuntu) + +1. Update the `apt` package index and install packages needed to use the fioup `apt` repository: + + ``` + sudo apt update + sudo apt install -y apt-transport-https ca-certificates curl gnupg + ``` + +1. Download the public signing key for the package repositories: + + ``` + curl -L https://fioup.foundries.io/pkg/deb/dists/stable/Release.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/fioup-stable.gpg + ``` + +1. Add the appropriate `apt` repository. + + ``` + echo 'deb [signed-by=/etc/apt/trusted.gpg.d/fioup-stable.gpg] https://fioup.foundries.io/pkg/deb stable main' | sudo tee /etc/apt/sources.list.d/fioup.list + ``` + +1. Install composectl + + ``` + sudo apt update && sudo apt install composectl + ``` + +### Install The Development Version (from source) + ```commandline git clone https://github.com/foundriesio/composeapp.git ``` From 8db43af1a796f8e5c83fb3f62aef53eb9738fa21 Mon Sep 17 00:00:00 2001 From: Mike Sul Date: Thu, 19 Feb 2026 15:25:58 +0100 Subject: [PATCH 2/2] docs: add info on publishing deb package to archive Signed-off-by: Mike Sul --- RELEASING.md | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/RELEASING.md b/RELEASING.md index 52b5667..883502a 100644 --- a/RELEASING.md +++ b/RELEASING.md @@ -64,4 +64,20 @@ git push origin v1.1.0 This triggers GitHub Actions to build artifacts and create the GitHub Release: * Linux binaries for amd64 and arm64. -* Debian artifacts (`"deb"`) for amd64 and arm64. \ No newline at end of file +* Debian artifacts (`"deb"`) for amd64 and arm64. + +### Publish Debian Packages to Archive + +Assume we are releasing v1.1.0 + +``` + mkdir /tmp/archive + ./debian/release-prep-archive.sh /tmp/archive 1.1.0 + ./debian/release-publish-archive.sh / /tmp/archive +``` + +As a sanity check run `find /tmp/archive` then push to the archive with: + +``` + gsutil rsync -r /tmp/archive/ gs://fioup.foundries.io/ +```