# List running package servers

The [`ffx repository server`](https://fuchsia.dev/reference/tools/sdk/ffx#ffx_repository_server) commands can identify and list
[Fuchsia package servers](https://fuchsia.dev/docs/concepts/packages/fuchsia_package_server) running on the host machine.

## Concepts

The package repository server is controlled by running the subcommands of
[`ffx repository server`](https://fuchsia.dev/reference/tools/sdk/ffx#ffx_repository_server). This server handles requests for
metadata about the available packages and delivers the file blobs that make up
the package contents.

There can be multiple package servers running on a single host machine. It is
useful to be able to list these running servers and their properties. These
properties are useful for troubleshooting or integrating package servers into a
higher level system or workflow automation.

## Basic command

    ffx repository server list

This command supports the [top level `ffx` options](https://fuchsia.dev/reference/tools/sdk/ffx) to
support programmatic use of the command:

- `--machine` produces machine reader friendly output
- `--schema` produces the JSON schema of the machine output

## Options

### --full

Produce the full details for each running package server.

### --name

Limit the output to package servers with the given name.
This option can be specified multiple times.

## Output

The default output is a list of:

- name
- listening address
- repo_path

For example:

    devhost      \[::\]:8083   /path/to/product_bundles/core.x64/repository

Full output adds additional fields:

- execution mode
- registration_aliases
- registration_storage_type
- registration_alias_conflict_mode
- pid

## Examples

### List all running servers

    ffx repository server list

### List full details of all running servers

    ffx repository server list --full

### List all details for the server

List servers named `devhost` or `devhost2` and print the output in JSON format:

    ffx --machine json-pretty repository server list --name devhost --name devhost2

[](https://issues.fuchsia.dev/issues/new?component=1439230&template=1881640&description=Issue+on:+https://fuchsia.dev/docs/development/tools/ffx/workflows/list-package-servers.md "Report a bug or suggest improvements on this page") [](https://cs.opensource.google/fuchsia/fuchsia/+/main:docs/development/tools/ffx/workflows/list-package-servers.md "View the source code of this page") [](https://ci.android.com/edit?repo=fuchsia/fuchsia/main&file=docs/development/tools/ffx/workflows/list-package-servers.md&cloneRepo=fuchsia/fuchsia:refs/heads/main&fullPath=fuchsia/docs/development/tools/ffx/workflows/list-package-servers.md "Edit the source code of this page")