# Installation

Source: https://libtmux.org/en/perl/latest/guides/installation/

> Installation: LibTmux documentation.

These distributions are unpublished. Use Perl 5.44.0 and install core before
workspace or optional async. Use the repository's pinned cpm author setup,
or an existing cpm installation. From the repository root:

```console
$ cpm install \
    --global \
    ./packages/core
```

```console
$ cpm install \
    --global \
    ./packages/workspace
```

```console
$ cpm install \
    --global \
    ./packages/async
```

Core and workspace need only the Perl standard library at runtime. Async adds
Future, IO::Async, IO::Async::Loop::Ppoll and IO::Ppoll. Its caller supplies a
Ppoll loop; IO::Ppoll includes an XS extension. See the
[async guide](https://libtmux.org/en/perl/latest/guides/async/) for construction and cleanup.
Configure/test/develop requirements remain separate.
To inspect installed documentation:

```console
$ perldoc LibTmux::Server
```

The [contributor guide](https://github.com/libtmux/libtmux-perl/blob/352715a4fa66a96eed7763b90daaa536aa2f121d/.github/CONTRIBUTING.md) documents pinned local
provisioning, archive builds, and isolated installed-consumer verification.
No PAUSE upload, tag, or release is implied by source installation.