Skip to content

Feat 532: APT installation support with validation and documentation#561

Draft
Leay15 wants to merge 24 commits intosuperradcompany:mainfrom
AurIAL-Rocks:feature/532-apt-support
Draft

Feat 532: APT installation support with validation and documentation#561
Leay15 wants to merge 24 commits intosuperradcompany:mainfrom
AurIAL-Rocks:feature/532-apt-support

Conversation

@Leay15
Copy link
Copy Markdown

@Leay15 Leay15 commented Apr 16, 2026

This pull request closes #532
It introduces comprehensive support for APT (Debian/Ubuntu) packaging and repository management for the project, including CI/CD workflow changes, documentation updates, and improvements to the CLI's self-management commands. The changes automate building, validating, and publishing Debian packages and repositories, and ensure that users installing via APT receive appropriate update and uninstall guidance.

APT packaging and repository automation:

  • Added new jobs to .github/workflows/check.yml to build, validate, and test Debian packages and signed APT repositories for both x86_64 and aarch64 architectures, including smoke tests in KVM environments.

  • Extended .github/workflows/release.yml to package, sign, and publish APT repositories to GitHub Pages as part of the release process, with a preparatory job to coordinate release context and ensure correct source SHA and tag usage.

Documentation improvements:

  • Updated README.md to provide clear instructions for installing the CLI via the new APT repository, including keyring setup and repository configuration for Debian/Ubuntu users.

CLI enhancements for APT awareness:

  • Modified crates/cli/lib/commands/self_cmd.rs so that if the CLI is installed via APT, microsandbox self update and microsandbox self uninstall will print appropriate notices instead of performing direct actions, to prevent conflicts with package-managed installations.

These changes ensure robust, automated packaging and updates for Debian-based systems. Also let open the possibility for support another Linux Arch.

Tested on:
Pop!_OS 24.04 LTS
Podman instead Docker

@toksdotdev
Copy link
Copy Markdown
Member

hey @Leay15. happy to see you contributing :) ok, gonna take a look at this over the weekend.

@Leay15
Copy link
Copy Markdown
Author

Leay15 commented Apr 17, 2026

Thank you @toksdotdev!

I put this points here for discussing it:

  • The 'REVISION' value is not defined yet, I put some hardcoded value for being able to test it (I'm thinking about taking commit sha but I prefer to discuss it with you :) )
  • The gpg signs is not closed yet, I'm not quite sure if will be given by CI vars or by Env file

Happy to hear all the comments about 😄

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Support APT (apt) installer

2 participants