feat: build debian package (r0gue-io#817)

* feat: build a debian package for pop-cli

* feat: build debian package in release workflow

* fix: PR feedback

* fix: use correct pop-cli webpage

* doc: installation instructions

Author: moliholy

.github/workflows/release.yml

@@ -84,6 +84,42 @@ jobs:
           files: |
             ${{ env.path }}/${{ env.package }}
 
+  build-debian:
+    name: Build Debian Package
+    runs-on: ubuntu-22.04
+    permissions:
+      contents: write
+    if: github.event_name == 'release'
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          ref: ${{ github.event.inputs.ref }}
+
+      - name: Install build dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y curl git debhelper libssl-dev pkg-config protobuf-compiler
+          curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
+
+      - name: Build Debian package
+        run: |
+          . "$HOME/.cargo/env"
+          dpkg-buildpackage -us -uc -d
+
+      - name: Upload Debian package artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: pop-cli-debian-package
+          path: ${{ github.workspace }}/../pop-cli_*.deb
+
+      - name: Upload Debian package to release
+        uses: softprops/action-gh-release@v1
+        with:
+          files: |
+            ${{ github.workspace }}../pop-cli_*.deb
+
   publish-homebrew:
     name: Publish to Homebrew
     runs-on: ubuntu-latest

.gitignore

@@ -11,3 +11,9 @@ debug
 .idea
 .vscode
 .envrc
+
+debian/pop-cli/
+debian/debhelper-build-stamp
+debian/files
+debian/pop-cli.substvars
+debian/.debhelper

README.md

@@ -16,7 +16,7 @@
 
 ## Installation
 
-You can install Pop CLI 
+You can install Pop CLI
 - from homebrew:
 ```shell
 brew install r0gue-io/pop-cli/pop
@@ -25,8 +25,12 @@ brew install r0gue-io/pop-cli/pop
 ```shell
 cargo install --force --locked pop-cli
 ```
+- from Debian package (download from [releases](https://github.com/r0gue-io/pop-cli/releases)):
+```shell
+sudo dpkg -i pop-cli_*.deb
+```
 
-> :information_source: Pop CLI requires Rust 1.91 or later.
+> :information_source: Pop CLI requires Rust 1.91.1 or later.
 
 You can also install Pop CLI using the [Pop CLI GitHub repo](https://github.com/r0gue-io/pop-cli):
 

debian/changelog

@@ -0,0 +1,6 @@
+pop-cli (0.12.1-1) unstable; urgency=medium
+
+  * Initial Debian package release
+  * Version 0.12.1 of pop-cli
+
+ -- R0GUE <go@r0gue.io>  Wed, 04 Dec 2025 00:00:00 +0000

debian/control

@@ -0,0 +1,22 @@
+Source: pop-cli
+Section: devel
+Priority: optional
+Maintainer: R0GUE <go@r0gue.io>
+Build-Depends: debhelper-compat (= 13),
+               cargo (>= 1.91.1),
+               rustc (>= 1.91.1),
+               libssl-dev,
+               pkg-config,
+               protobuf-compiler
+Standards-Version: 4.7.0
+Homepage: https://onpop.io/
+Vcs-Git: https://github.com/r0gue-io/pop-cli.git
+Vcs-Browser: https://github.com/r0gue-io/pop-cli
+
+Package: pop-cli
+Architecture: any
+Depends: ${shlibs:Depends}, ${misc:Depends}
+Description: An all-in-one tool for Polkadot development
+ Pop CLI is a comprehensive command-line tool for developing on Polkadot.
+ It provides functionality for smart contract development, parachain
+ development, and other Polkadot ecosystem tools.

debian/copyright

@@ -0,0 +1,24 @@
+Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
+Upstream-Name: pop-cli
+Upstream-Contact: R0GUE <go@r0gue.io>
+Source: https://github.com/r0gue-io/pop-cli
+
+Files: *
+Copyright: 2025 R0GUE
+License: GPL-3.0
+
+License: GPL-3.0
+ This program is free software: you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation, version 3 of the License.
+ .
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ GNU General Public License for more details.
+ .
+ You should have received a copy of the GNU General Public License
+ along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ .
+ On Debian systems, the complete text of the GNU General
+ Public License version 3 can be found in "/usr/share/common-licenses/GPL-3".

debian/install

@@ -0,0 +1,18 @@
+#!/usr/bin/make -f
+
+export DH_VERBOSE = 1
+
+%:
+	dh $@
+
+override_dh_auto_clean:
+	cargo clean
+
+override_dh_auto_build:
+	cargo build --release --locked
+
+override_dh_auto_test:
+	# Skip tests during package build
+
+override_dh_auto_install:
+	install -D -m 755 target/release/pop debian/pop-cli/usr/bin/pop