What it provides

• The DeviceStore component — keeps remote DICOM devices in the database, working in tandem with the built-in Devices component. Devices carry a per-device identity policy (none, username, password); auto-added devices receive configurable defaults.

• New tiny-pacs subcommands:

  • tiny-pacs devices list|add|update|remove|echo — manage the devices stored in the database (--format json|yaml supported);

  • tiny-pacs components list — registry contents with origin (built-in vs providing distribution) and enabled/disabled state;

  • tiny-pacs db info — schema versions and table row counts;

  • tiny-pacs storage stats|verify|cleanup — storage usage statistics (--quota exits 2 when exceeded), record/file consistency check and safe cleanup of stuck in-progress records and orphan files (dry run by default, --apply to delete).

Installation

pip install tiny-pacs-admin

or with the convenience extra:

pip install tiny_pacs[admin]

Installing the extension never changes server behaviour: the DeviceStore component stays disabled until enabled in the configuration, and the CLI subcommands are additive.

Configuration

Enable the component and optionally tune the defaults applied to auto-added devices:

components:
  DeviceStore:
    on: true
    default_identity: none    # none | username | password
    default_port: 11112

The administration commands work offline against the configured database. Administration against SQLite requires a file-based database — set db_name and mode: rwc on the Database component (the in-memory default cannot persist data between command invocations):

components:
  Database:
    on: true
    db_name: pacs.db
    mode: rwc

The YAML-configured devices of the Devices component are imported into the database at server start (upsert by AE title), so the configuration remains the source of truth for configured devices. When using DeviceStore, disable auto_add on the Devices component so newly seen devices are only bookkept in the database.

Documentation

See the Administration tutorial in the tiny_pacs documentation.