INSTALL.xml

<?xml version="1.0" encoding="UTF-8"?>
<article version="5.2" xmlns="http://docbook.org/ns/docbook">
  <info>
    <title>INSTALL</title>

    <author>
      <personname><firstname>Andrew</firstname><surname>Speer</surname></personname>
    </author>

    <pubdate>2025-12-04</pubdate>
  </info>

  <section>
    <title>Installation via CPAN</title>

    <para>You can install the base WebDyne module, and all prerequisites, with: <screen>$ perl -MCPAN -e 'install WebDyne'</screen>or alternatively on modern systems: <screen>$ cpanm WebDyne</screen>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 <link
    xlink:href="https://webdyne.org" xmlns:xlink="http://www.w3.org/1999/xlink">https://webdyne.org</link>) or via an installer module which will do the work for you. </para>
  </section>

  <section>
    <title>Installation of the PSGI (Plack) version</title>

    <para>To use the PSGI version of WebDyne install the Plack module via: <screen>$ cpanm Plack</screen> You can then start the WebDyne server via the command <screen>$ webdyne.psgi --test</screen>
    To validate it is working. See instruction at <link xlink:href="https://webdyne.org" xmlns:xlink="http://www.w3.org/1999/xlink">https://webdyne.org</link> for additional usage
    information</para>
  </section>

  <section>
    <title>Installation of the Apache Version</title>

    <para>The base WebDyne module comes with an installer module for Apache. It will be installed into whichever bin location (usually <filename>/usr/local/bin</filename>) your CPAN
    configuration defaults to. You can run the installer with the command: <screen>$ wdapacheinit</screen>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 <command>wdapacheinit --help</command> to review options</para>
  </section>

  <section>
    <title>Installation via Manual Build</title>

    <para>You can download and install the base WebDyne module with the following commands after it is unpacked: <screen>$ perl Makefile.PL
$ make 
$ make test 
$ make install</screen>You will need to download and install all prerequisite modules manually. Modules required should be listed when you run the <command>perl Makefile.PL</command> 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.</para>
  </section>
</article>