jkfran/killport

A command-line tool to kill processes and containers running on specified ports.

Rust

1,844

170 commits

updated Sep 21, 2026

See the code

README

killport

A command-line tool to kill processes and containers running on specified ports.

Features

Kill processes and containers by port number (single or multiple ports)
Container runtime support — works with Docker, OrbStack, Podman, Colima, and any OCI-compatible runtime
Dry-run mode — preview what would be killed without doing it
Signal control — send any signal (SIGTERM, SIGKILL, SIGINT, etc.)
Shell completions — built-in support for bash, zsh, and fish
Cross-platform — Linux, macOS, and Windows

Installation

Homebrew

brew install killport

Cargo

cargo install killport

Shell script

curl -sL https://bit.ly/killport | sh

Add $HOME/.local/bin to your PATH if it's not already there.

Binary releases

Download pre-built binaries from the releases page. Each release includes shell completions and a man page.

Usage

killport [OPTIONS] <ports>...

Examples

Kill whatever is using port 8080:

killport 8080

Kill multiple ports at once:

killport 3000 8080 9090

Send SIGTERM instead of SIGKILL:

killport -s sigterm 8080

Dry run — see what would be killed:

killport --dry-run 8080
# Would kill process 'node' listening on port 8080

Kill only containers (skip native processes):

killport --mode container 8080

Suppress exit code 2 when nothing is found (useful in scripts):

killport --no-fail 8080

Options

Flag	Description
`-m, --mode <MODE>`	Target mode: `auto` (default), `process`, or `container`
`-s, --signal <SIG>`	Signal to send (default: `SIGKILL`). See supported signals
`--dry-run`	Preview what would be killed without terminating anything
`--no-fail`	Exit 0 even when no matching process or container is found
`-v, --verbose`	Increase verbosity (repeat for more: `-vv`, `-vvv`)
`-q, --quiet`	Decrease verbosity (repeat for less: `-qq`)
`-h, --help`	Show help
`-V, --version`	Show version

Exit codes

Code	Meaning
`0`	Target(s) found and killed (or `--no-fail` was used)
`1`	Error (permission denied, internal failure, etc.)
`2`	No matching process or container found on the specified port(s)

How it works

In auto mode (default), killport:

Checks if a container runtime is available
If containers are found on the port, kills only the containers (port forwarder processes like docker-proxy or OrbStack Helper are automatically skipped)
If no containers are found, falls back to killing native processes

Use --mode process or --mode container to target only one type.

Shell completions

Shell completions are included in release tarballs under completions/. To install:

bash — copy to ~/.local/share/bash-completion/completions/killport

zsh — copy to a directory in your $fpath (e.g., ~/.zsh/completions/_killport)

fish — copy to ~/.config/fish/completions/killport.fish

Contributing

Contributions are welcome. See CONTRIBUTING.md and CODE_OF_CONDUCT.md.

License

MIT

Project health

crates.io

killport

Latest release

2.0.2 · Aug 1, 2026

Releases this year

Significant stargazers

fregante

1,983 followers · starred May 2023

Shizuo Fujita

283 followers · starred Apr 2023

Kevin Amado

138 followers · starred Apr 2023

Alex Collins

373 followers · starred Apr 2023

Similar repos

sindresorhus/fkill-cli

Fabulously kill processes. Cross-platform.

7,008

treadiehq/port-kill

Port Kill helps you find and free ports and caches blocking your dev work.

2,041

sindresorhus/fkill

Fabulously kill processes. Cross-platform.

798

padovanl/portop

htop for your ports. Inspect processes, Docker & systemd, detect port drift, audit Compose, and…

229

productdevbook/port-killer

A powerful cross-platform port management tool for developers. Monitor ports, manage Kubernetes…

5,100

sindresorhus/pid-port

Get the ID of the process that uses a certain port

150

hunzo1/Blitz

theopfr/somo

A human-friendly alternative to netstat for socket and port monitoring on Linux and macOS.

2,624

jkfran/killport

A command-line tool to kill processes and containers running on specified ports.

Rust

1,844

170 commits

updated Sep 21, 2026

See the code

README

killport

A command-line tool to kill processes and containers running on specified ports.

Features

Kill processes and containers by port number (single or multiple ports)
Container runtime support — works with Docker, OrbStack, Podman, Colima, and any OCI-compatible runtime
Dry-run mode — preview what would be killed without doing it
Signal control — send any signal (SIGTERM, SIGKILL, SIGINT, etc.)
Shell completions — built-in support for bash, zsh, and fish
Cross-platform — Linux, macOS, and Windows

Installation

Homebrew

brew install killport

Cargo

cargo install killport

Shell script

curl -sL https://bit.ly/killport | sh

Add $HOME/.local/bin to your PATH if it's not already there.

Binary releases

Download pre-built binaries from the releases page. Each release includes shell completions and a man page.

Usage

killport [OPTIONS] <ports>...

Examples

Kill whatever is using port 8080:

killport 8080

Kill multiple ports at once:

killport 3000 8080 9090

Send SIGTERM instead of SIGKILL:

killport -s sigterm 8080

Dry run — see what would be killed:

killport --dry-run 8080
# Would kill process 'node' listening on port 8080

Kill only containers (skip native processes):

killport --mode container 8080

Suppress exit code 2 when nothing is found (useful in scripts):

killport --no-fail 8080

Options

Flag	Description
`-m, --mode <MODE>`	Target mode: `auto` (default), `process`, or `container`
`-s, --signal <SIG>`	Signal to send (default: `SIGKILL`). See supported signals
`--dry-run`	Preview what would be killed without terminating anything
`--no-fail`	Exit 0 even when no matching process or container is found
`-v, --verbose`	Increase verbosity (repeat for more: `-vv`, `-vvv`)
`-q, --quiet`	Decrease verbosity (repeat for less: `-qq`)
`-h, --help`	Show help
`-V, --version`	Show version

Exit codes

Code	Meaning
`0`	Target(s) found and killed (or `--no-fail` was used)
`1`	Error (permission denied, internal failure, etc.)
`2`	No matching process or container found on the specified port(s)

How it works

In auto mode (default), killport:

Checks if a container runtime is available
If containers are found on the port, kills only the containers (port forwarder processes like docker-proxy or OrbStack Helper are automatically skipped)
If no containers are found, falls back to killing native processes

Use --mode process or --mode container to target only one type.

Shell completions

Shell completions are included in release tarballs under completions/. To install:

bash — copy to ~/.local/share/bash-completion/completions/killport

zsh — copy to a directory in your $fpath (e.g., ~/.zsh/completions/_killport)

fish — copy to ~/.config/fish/completions/killport.fish

Contributing

Contributions are welcome. See CONTRIBUTING.md and CODE_OF_CONDUCT.md.

License

MIT

Project health

crates.io

killport

Latest release

2.0.2 · Aug 1, 2026

Releases this year

Significant stargazers

fregante

1,983 followers · starred May 2023

Shizuo Fujita

283 followers · starred Apr 2023

Kevin Amado

138 followers · starred Apr 2023

Alex Collins

373 followers · starred Apr 2023

Similar repos

sindresorhus/fkill-cli

Fabulously kill processes. Cross-platform.

7,008

treadiehq/port-kill

Port Kill helps you find and free ports and caches blocking your dev work.

2,041

sindresorhus/fkill

Fabulously kill processes. Cross-platform.

798

padovanl/portop

htop for your ports. Inspect processes, Docker & systemd, detect port drift, audit Compose, and…

229

productdevbook/port-killer

A powerful cross-platform port management tool for developers. Monitor ports, manage Kubernetes…

5,100

sindresorhus/pid-port

Get the ID of the process that uses a certain port

150

hunzo1/Blitz

theopfr/somo

A human-friendly alternative to netstat for socket and port monitoring on Linux and macOS.

2,624