Skip to main content

portcheck

See what's using a port and free it safely: which process, who started it, stop it. Fixes "port already in use" (EADDRINUSE, Address already in use).

pipx install portcheck-tool # or: pip install portcheck-tool / uv tool install portcheck-tool

portcheck 3000              # who holds port 3000? (exit 1 if in use)
portcheck kill 3000         # stop it, after confirming; never system processes
portcheck free              # a free port
portcheck                   # interactive view of every listening port
PORT  PROTO  STATUS  PID    PROCESS  USER
3000  tcp    in-use  41852  node     alice

Works on macOS, Linux and Windows (x64 and arm64). This package installs the native portcheck binary; there's no Python code and nothing is downloaded at runtime.

Also available for VS Code, JetBrains IDEs, Edge and Firefox, and through Homebrew, Scoop and npm (npx portcheck-cli 3000).

Metadata

Release files for portcheck-tool 0.11.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for portcheck-tool 0.11.0
File Actions
portcheck_tool-0.11.0-py3-none-win_arm64.whl Python 3 none Windows ARM64 Details for portcheck_tool-0.11.0-py3-none-win_arm64.whl
portcheck_tool-0.11.0-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for portcheck_tool-0.11.0-py3-none-win_amd64.whl
portcheck_tool-0.11.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.musllinux_1_1_x86_64.whl Python 3 none Linux musl 1.1+ x86-64, Linux glibc 2.17+ x86-64 Details for portcheck_tool-0.11.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.musllinux_1_1_x86_64.whl
portcheck_tool-0.11.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl Python 3 none Linux musl 1.1+ ARM64, Linux glibc 2.17+ ARM64 Details for portcheck_tool-0.11.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl
portcheck_tool-0.11.0-py3-none-macosx_12_0_x86_64.whl Python 3 none macOS 12.0+ x86-64 Details for portcheck_tool-0.11.0-py3-none-macosx_12_0_x86_64.whl
portcheck_tool-0.11.0-py3-none-macosx_12_0_arm64.whl Python 3 none macOS 12.0+ ARM64 Details for portcheck_tool-0.11.0-py3-none-macosx_12_0_arm64.whl

Total release size: 32.2 MB

Release files / portcheck_tool-0.11.0-py3-none-win_arm64.whl

Download URL portcheck_tool-0.11.0-py3-none-win_arm64.whl
Size 5.1 MB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
57b2e3d80e770c889aa5dcb00a6aef6dd73718d02249319817ace2e0630a1201
BLAKE2b-256 checksum
How to use checksums
d75589758df71bdd849e1c1231ea6721ad57df159c56c598dbf77e66c2a4a63f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 25, 2026.

Transparency log

Release files / portcheck_tool-0.11.0-py3-none-win_amd64.whl

Download URL portcheck_tool-0.11.0-py3-none-win_amd64.whl
Size 5.7 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
9d3d5950388797fd2314c8e7db6a37458d169ef7667db5a103243448ed6f1447
BLAKE2b-256 checksum
How to use checksums
a6fb468c693bc3a9fac66359b21ec98cfcfae3b3874816718ecfcecd9fbdcf0e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 25, 2026.

Transparency log

Release files / portcheck_tool-0.11.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.musllinux_1_1_x86_64.whl

Download URL portcheck_tool-0.11.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.musllinux_1_1_x86_64.whl
Size 5.5 MB
Tags Linux glibc 2.17+ x86-64 Linux musl 1.1+ x86-64 Python 3
SHA-256 checksum
How to use checksums
53ca5f0866ad22603666397cc2317c077cc3513714aa99e73858d672fee3557f
BLAKE2b-256 checksum
How to use checksums
a4a8934c9bcde21be418fcc1372d2db4ab975b9ae10f91d6bfabdb7917c56d42
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 25, 2026.

Transparency log

Release files / portcheck_tool-0.11.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl

Download URL portcheck_tool-0.11.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl
Size 5.0 MB
Tags Linux glibc 2.17+ ARM64 Linux musl 1.1+ ARM64 Python 3
SHA-256 checksum
How to use checksums
bf08bec11e843bf4417849075c9ba1194defb9484a09f55003aafc094cf6849c
BLAKE2b-256 checksum
How to use checksums
04c01c8f9a9e262afe53f984c5e22996aad1ec23a71be98c1fe11729a3e6d986
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 25, 2026.

Transparency log

Release files / portcheck_tool-0.11.0-py3-none-macosx_12_0_x86_64.whl

Download URL portcheck_tool-0.11.0-py3-none-macosx_12_0_x86_64.whl
Size 5.7 MB
Tags Python 3 macOS 12.0+ x86-64
SHA-256 checksum
How to use checksums
f1341fc4e76d3a37ceef6ae1ad603e10afd1ab5b9d0cc319847c2602a1ef2077
BLAKE2b-256 checksum
How to use checksums
094d24f051eef79590f71a859cb55830926b8ae810516856d0f3a4370146d913
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 25, 2026.

Transparency log

Release files / portcheck_tool-0.11.0-py3-none-macosx_12_0_arm64.whl

Download URL portcheck_tool-0.11.0-py3-none-macosx_12_0_arm64.whl
Size 5.2 MB
Tags Python 3 macOS 12.0+ ARM64
SHA-256 checksum
How to use checksums
4acbd5a6709638f6fc81d5f1f9441294338313ac42be3319a30b3016d78c518c
BLAKE2b-256 checksum
How to use checksums
9cfdb29b658ad583c0551e907162a5138afc11c570cdf63287c99c4edb5851fd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 25, 2026.

Transparency log

Security for portcheck-tool 0.11.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 6 files in this release have been uploaded with provenance metadata.

Select from 6 files

Attestation for portcheck_tool-0.11.0-py3-none-win_arm64.whl

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 25, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page