Skip to content

portler clean

Remove runtime files and release port reservations.

bash
portler clean [--ports] [--global] [--force]

Behavior

Plain portler clean removes the local .portler/ runtime files and releases this project's ports from the global registry (~/.portler/ports.json).

Clean refuses to run while services are running; pass --force to stop them first.

Options

FlagDescription
--portsOnly release this project's port reservations, keeping .portler/
--globalPrune stale entries left behind by crashed or deleted projects from the global registry (entries whose port is free again)
--forceStop running services first

Examples

bash
portler clean            # remove .portler/ + release this project's ports
portler clean --ports    # only release ports
portler clean --global   # machine-wide registry cleanup
portler clean --force    # stop services, then clean

Released under the MIT License.