# INSTALL

Andrew Speer
2025-12-04

## Installation via CPAN

You can install the base WebDyne module, and all prerequisites, with:

    $ perl -MCPAN -e 'install WebDyne'

or alternatively on modern systems:

    $ cpanm WebDyne

This assumes you have already setup and initialised CPAN appropriately for your environment. Note that WebDyne will not be automatically usable after this - you must modify your Web server configuration to make it active or install the Plack PSGI version (see below). You may do this manually (referring to the documentation available in the doc directory, or at https://webdyne.org) or via an installer module which will do the work for you.

## Installation of the PSGI (Plack) version

To use the PSGI version of WebDyne install the Plack module via:

    $ cpanm Plack

You can then start the WebDyne server via the command

    $ webdyne.psgi --test

To validate it is working. See instruction at https://webdyne.org for additional usage information

## Installation of the Apache Version

The base WebDyne module comes with an installer module for Apache. It will be installed into whichever bin location (usually `/usr/local/bin`) your CPAN configuration defaults to. You can run the installer with the command:

    $ wdapacheinit

It will use reasonable defaults to try and locate and update your Apache config, Webdyne cache dir. etc. If you need to alter the defaults run `wdapacheinit --help` to review options

## Installation via Manual Build

You can download and install the base WebDyne module with the following commands after it is unpacked:

    $ perl Makefile.PL
    $ make
    $ make test
    $ make install

You will need to download and install all prerequisite modules manually. Modules required should be listed when you run the `perl Makefile.PL` command. Similarly to the CPAN install you will either need to adjust your Web server configuration manually to serve WebDyne pages, or run/download the appropriate installer or Plack module.