datasette-ports 0.1

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 plugin in the same environment as Datasette.

datasette install datasette-ports

Usage

Run this 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

[
  {
    "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 plugin locally, first checkout the code. You can confirm it is available like this:

cd datasette-ports
# Confirm the plugin is visible
uv run datasette plugins

To run the tests:

uv run pytest