Skip to content

Conversation

@ebauger
Copy link

@ebauger ebauger commented Jul 31, 2025

Hey Caido Team!
@Sytten , @Corb3nik

I've got a suggestion for you: let's set up an official pkg.caido.io or deb.caido.io repository for Debian and its friends. This would make installing Caido super easy for tons of users!


How Caido Installs Now (via zbranch.io)

Right now, folks can install Caido using the pkg.zbranch.io repository with these commands:

curl -fsSL https://pkg.zbranch.io/signing_key.asc | sudo gpg --dearmor -o /etc/apt/keyrings/pkg-zbranch-io.gpg
echo "deb [signed-by=/etc/apt/keyrings/pkg-zbranch-io.gpg] https://pkg.zbranch.io/ caido main" | sudo tee /etc/apt/sources.list.d/pkg-zbranch-io.list > /dev/null
sudo apt update
sudo apt install caido

What to do if you like the idea?

If you're on board with creating your own official repo, here's what you'd need to do:

  • Add Your GPG Private Key to GitHub Actions: You'll need to set this up as a secret. You can generate the key using aptify init-keys.

  • Add Your RCLONE_CONFIG to GitHub Actions: This also needs to be a secret. Here's an example of what that configuration might look like:

    [pkg.caido.io]
    type = s3
    provider = Cloudflare
    access_key_id = ***
    secret_access_key = ***
    region = auto
    endpoint = ***
    no_check_bucket = true
    
  • Tweak your Github Workflow: You'll want to adapt your .github/workflows/update-apt-repo.yml workflow to work with your new rclone configuration.

What do you think? I'm happy to help if you have any questions!

- Introduced `aptify.yml` to define the APT repository for Caido desktop packages.
- Created GitHub Actions workflow `update-apt-repo.yml` to automate the update process, including package downloads and repository synchronization.
- Added `download_deb_packages.sh` script to fetch and manage .deb packages from the Caido API, with error handling and logging features.
@Sytten
Copy link
Member

Sytten commented Aug 5, 2025

Thanks for providing the basis for this. I agree we should do that. It might look. A bit different since we will likely publish from our internal tooling, but I really appreciate the contribution :)

@ebauger
Copy link
Author

ebauger commented Aug 5, 2025

Thanks for providing the basis for this. I agree we should do that. It might look. A bit different since we will likely publish from our internal tooling, but I really appreciate the contribution :)

This is a suggested implementation, but I expect it will vary depending on your internal tools.

I used Cloudflare's R2 to run an S3 instance and rclone and aptify.

Another question @Sytten: I have another proposal to amend the .deb packages. Where I should put the proposal ?

@Sytten
Copy link
Member

Sytten commented Aug 5, 2025

Yeah cloudflare is great, we already use it for caido.download.

For the deb improvements can you open an issue on the caido/caido repo. FYI we us electron-builder v25 to build them at the moment.

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.

2 participants