datasette-ports 0.2

Find all currently running Datasette instances and list their ports

datasette-ports

Find all currently running Datasette instances on your machine and list their ports, databases, versions and plugins.

Installation

Install this as a plugin in the same environment as Datasette.

datasette install datasette-ports

Or run it directly using uvx:

uvx datasette-ports

Or install it as a standalone tool:

uv tool install datasette-ports
datasette-ports

Usage

If installed as a Datasette plugin:

datasette ports

Or as a standalone command:

datasette-ports

This uses lsof to find all Python processes listening on TCP ports, then probes each one to check if it is a Datasette instance. For each instance found it displays the URL, Datasette version, attached databases and installed plugins.

Example output:

http://127.0.0.1:8007/ - v1.0a26
  Databases: simonwillisonblog
  Plugins: datasette-llm, datasette-secrets
http://127.0.0.1:8001/ - v1.0a26
  Databases: creatures
  Plugins: datasette-extract, datasette-llm, datasette-secrets
http://127.0.0.1:8900/ - v0.65.2
  Databases: logs
http://0.0.0.0:8014/ - v1.0a26
  Databases: content, trees, _internal
  Plugins: datasette-llm, datasette-visible-internal-db

JSON output

Use --json to get machine-readable output:

datasette ports --json
# or
datasette-ports --json

[
  {
    "url": "http://127.0.0.1:8007/",
    "host": "127.0.0.1",
    "port": 8007,
    "version": "1.0a26",
    "databases": [
      "simonwillisonblog"
    ],
    "plugins": [
      "datasette-llm",
      "datasette-secrets"
    ]
  },
  {
    "url": "http://127.0.0.1:8900/",
    "host": "127.0.0.1",
    "port": 8900,
    "version": "0.65.2",
    "databases": [
      "logs"
    ],
    "plugins": []
  }
]

Development

To set up this project locally, first checkout the code. You can confirm it is available like this:

cd datasette-ports
uv run datasette-ports --help
# Or:
uv run datasette ports --help

To run the tests:

uv run pytest