# CommunityToolkit.Aspire.Hosting.Perl

- Module: `CommunityToolkit.Aspire.Hosting.Perl`
- Version: `13.6.1`
- Import path: `apphost/modules/aspire`
- Source: [GitHub](https://github.com/CommunityToolkit/Aspire/tree/d9c2addac6f527ef2e33712d290b84574b455a3b)
- Functions: `12`
- Types: `1`

## Handles

- [PerlAppResource](/reference/api/go/communitytoolkit.aspire.hosting.perl/perlappresource.md) -- `handle` - 8 members

## Functions

- [AddPerlApi](/reference/api/go/communitytoolkit.aspire.hosting.perl/addperlapi.md) -- `method` - on `DistributedApplicationBuilder` -- Adds a Perl API server resource (e.g., Mojolicious, Dancer2) to the application model. Passes the `daemon` subcommand so HTTP frameworks start a listener.
- [AddPerlExecutable](/reference/api/go/communitytoolkit.aspire.hosting.perl/addperlexecutable.md) -- `method` - on `DistributedApplicationBuilder` -- Adds a Perl executable (compiled binary or PAR-packed application) to the application model. The executable is run directly rather than through the `perl` interpreter.
- [AddPerlModule](/reference/api/go/communitytoolkit.aspire.hosting.perl/addperlmodule.md) -- `method` - on `DistributedApplicationBuilder` -- Adds a Perl module to the application model. The module is executed using `perl -MModule::Name -e "Module::Name->run()"`.
- [AddPerlScript](/reference/api/go/communitytoolkit.aspire.hosting.perl/addperlscript.md) -- `method` - on `DistributedApplicationBuilder` -- Adds a Perl script resource (worker, CLI tool, background service) to the application model.
- [WithCarton](/reference/api/go/communitytoolkit.aspire.hosting.perl/withcarton.md) -- `method` - on `PerlAppResource` -- Configures the Perl application to use Carton as its package manager. Carton manages dependencies via `cpanfile` and a lock file (`cpanfile.snapshot`), enabling reproducible builds. Use `WithProjectDependencies` to run `carton install` at startup.
- [WithCpanMinus](/reference/api/go/communitytoolkit.aspire.hosting.perl/withcpanminus.md) -- `method` - on `PerlAppResource` -- Configures the Perl application to use cpanm (App::cpanminus) as its package manager instead of the default cpan. Call this before `WithPackage` to change how packages are installed.
- [WithLocalLib](/reference/api/go/communitytoolkit.aspire.hosting.perl/withlocallib.md) -- `method` - on `PerlAppResource` -- Configures the Perl application to use a local::lib directory for module isolation. Sets `PERL5LIB`, `PERL_LOCAL_LIB_ROOT`, `PERL_MM_OPT`, and `PERL_MB_OPT` environment variables so that modules are resolved from and installed into the local directory.
- [WithPackage](/reference/api/go/communitytoolkit.aspire.hosting.perl/withpackage.md) -- `method` - on `PerlAppResource` -- Adds a Perl package (module) to be installed before the application starts. Uses the configured package manager: cpan by default, or cpanm if `WithCpanMinus` was called.
- [WithPerlbrew](/reference/api/go/communitytoolkit.aspire.hosting.perl/withperlbrew.md) -- `method` - on `PerlAppResource` -- Configures the Perl application to use a specific perlbrew-managed Perl version.
- [WithPerlbrewEnvironment](/reference/api/go/communitytoolkit.aspire.hosting.perl/withperlbrewenvironment.md) -- `method` - on `PerlAppResource` -- Configures the Perl application to use a specific perlbrew-managed Perl version. This resolves the Perl executable from the perlbrew installation and updates the resource's command and environment variables so that all subsequent operations use the specified Perl version.
- [WithPerlCertificateTrust](/reference/api/go/communitytoolkit.aspire.hosting.perl/withperlcertificatetrust.md) -- `method` - on `PerlAppResource` -- Configures certificate trust for the Perl application by setting SSL/TLS environment variables that common Perl HTTP libraries respect. Sets `SSL_CERT_FILE` (IO::Socket::SSL / LWP), `PERL_LWP_SSL_CA_FILE` (LWP::UserAgent), and `MOJO_CA_FILE` (Mojolicious) to the certificate bundle path provided by Aspire.
- [WithProjectDependencies](/reference/api/go/communitytoolkit.aspire.hosting.perl/withprojectdependencies.md) -- `method` - on `PerlAppResource` -- Configures project-level dependency installation for the Perl application. Runs the appropriate install command based on the active package manager: - - If the active package manager is `cpan` (the default), it is automatically switched to `cpanm` since `cpan` does not support `--installdeps`.
