# PLDS - Phoenix LiveDashboard Standalone
<!-- MDOC !-->
PLDS is a command line interface for [Phoenix LiveDashboard](https://github.com/phoenixframework/phoenix_live_dashboard)
with some additional extensions.
It's useful in environments where you can't install Phoenix or the dashboard.
This can be used to access remote systems that are reachable locally.
You can install PLDS by running the following command:
$ mix escript.install hex plds
Make sure the path used for installing escripts is available in your
If you installed Elixir with `asdf`, you'll need to run `asdf reshim elixir`
once the escript is built.
After that, you can start PLDS with the following command:
$ plds server --connect node_a --connect node_b --port 9000 --open
The dashboard will open a page in your browser.
Check the options available by typing `plds server --help`.
Note that the PLDS node will be hidden from the other nodes.
To try out features from the main branch you can alternatively
install the escript directly from GitHub like this:
$ mix escript.install github phoenixframework/plds
### Environment variables
PLDS accepts some configuration through environment variables.
The only one available today is:
* `PDLS_SECRET_KEY_BASE` - the secret base used for session encryption. It must
be at least 64 characters long. You can use OpenSSL or the [`:crypto.strong_rand_bytes/1`](https://erlang.org/doc/man/crypto.html#strong_rand_bytes-1) function to generate it.
`openssl rand -base64 48` if you have OpenSSL available.
By default it's a random value.
## Preinstalled tools
- Ecto with extras - works for PostgreSQL databases.
- Broadway Dashboard - to inspect Broadway pipelines.
## Disabled pages
Note that some pages will be disabled when using PLDS. "Metrics" page is disabled
because we can't tell which module is responsible for the data upfront.
The "Request logger" page is disabled as well.
"OS Data" page is enabled only if the node has the `os_mon` application running.
<!-- MDOC !-->
PLDS is primarily a Phoenix web application and can be setup as such:
git clone https://github.com/phoenixframework/plds.git
# Run the PLDS server
# To test escript
MIX_ENV=prod mix escript.build
MIT License. Copyright (c) 2021 Philip Sampaio.