diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
new file mode 100644
index 0000000..da075af
--- /dev/null
+++ b/.github/workflows/release.yml
@@ -0,0 +1,34 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+
+jobs:
+  build-deb:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Install cargo-deb
+        run: cargo install cargo-deb
+
+      - name: Build release binary
+        run: cargo build --release
+
+      - name: Build .deb package
+        run: cargo deb --no-build
+
+      - name: Upload .deb to release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: target/debian/*.deb
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
diff --git a/Cargo.toml b/Cargo.toml
index ca76f2f..1a949ad 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -2,6 +2,13 @@
 name = "lines"
 version = "0.1.0"
 edition = "2024"
+authors = ["janvete"]
+description = "TUI for running frequently used commands"
+license = "MIT"
+repository = "https://github.com/janvete/lines"
+homepage = "https://github.com/janvete/lines"
+keywords = ["cli", "tui", "ssh", "commands"]
+categories = ["command-line-utilities"]
 
 [dependencies]
 base64 = "0.22.1"
@@ -12,3 +19,15 @@ directories = "6.0.0"
 ratatui = "0.30.1"
 toml = "1.1.2"
 walkdir = "2.5.0"
+
+
+[package.metadata.deb]
+maintainer = "janvete <jan.vete@example.com>"
+copyright = "2026, janvete"
+extended-description = "TUI application for quickly running frequently used commands from markdown files."
+section = "utils"
+priority = "optional"
+assets = [
+    ["target/release/lines", "usr/bin/lines", "755"],
+    ["README.md", "usr/share/doc/lines/README.md", "644"],
+]
diff --git a/README.md b/README.md
index f1e46f2..24c6f2d 100644
--- a/README.md
+++ b/README.md
@@ -4,11 +4,29 @@ A TUI app for quickly running frequently used commands — ideal for SSH scripts
 
 ## Installation
 
+### macOS (Homebrew)
+
 ```bash
 brew tap janvete/tools
 brew install lines
 ```
 
+### Debian / Ubuntu (.deb)
+
+Download the latest `.deb` from the [GitHub Releases](https://github.com/janvete/lines/releases) page and install it:
+
+```bash
+sudo apt install ./lines_*.deb
+# or
+sudo dpkg -i lines_*.deb
+```
+
+### From source
+
+```bash
+cargo install --git https://github.com/janvete/lines
+```
+
 ## Usage
 
 ```bash