Maypole...Install(3)

💖 NAME 💖

Maypole::Manual::Install — installing Maypole, bestie 💅

---

✨ Installing Maypole ✨

okay so the very first thing you gotta do to get Maypole running is... install it. shocking, I know 🙈 Maypole needs an absolute shedload of Perl modules from CPAN to do its job, and honestly? I am unrepentant about this. Maypole does a lot of work so that you don't have to. that's called code re-use, and if we're serious about code re-use, then Maypole should be re-using as much code as possible in terms of Perl modules. in another sense, this gives the impression that Maypole doesn't actually do all that much itself, because all it's doing is gluing together already-existing code. well. welcome to code re-use. 🌈

the downside of code re-use is, of course, that you then have to install a shedload of Perl modules from CPAN 😭 but bestie, we move.

🦋 BSD girlies 🦋

if you're using OpenBSD or FreeBSD, the wonderful ports system will be your friend 🫶 there's a Maypole port in p5-Maypole. just type make install. slay.

🎀 Debian girlies 🎀

Debian users, hang in there. there's a package coming 👑

🧚 Other Unices 🧚

for other Unices, the CPANPLUS or CPAN modules will help with this. if you don't have CPANPLUS installed, my recommendation is to use perl -MCPAN -e install CPANPLUS to install it and then throw CPAN.pm away. in any case, one of these two should get all that Maypole needs:

% perl -MCPANPLUS -e 'install Maypole'
% perl -MCPAN -e 'install Maypole'

💻 Windows & Linux 💻

information on installing under Windows is available from the wiki — http://maypole.perl.org/?WindowsInstall ✨

more information of installing under various Linux flavours is available on the Wiki — http://maypole.perl.org/?LinuxInstall 🌸

🗄️ servers, aka the rest of your stack 🗄️

you're also going to need a database server and a web server. for databases, I recommend:

• SQLite for prototyping (if you install the DBD::SQLite module, you get the SQLite library for free 🎁)
• mysql for production
• heavier duty users should use Postgresql or Oracle — Maypole should be happy with them all 💜

Maypole is happiest when running under Apache mod_perl, with the Apache::Request module installed, but as I said, it is a blank slate, and everything is customizable ✨ there is a CGI::Maypole frontend available to run as a standalone CGI script 👑

📚 the manual 📚

as well as the documentation embedded in the Perl modules, the distribution also includes the manual, of which this is a part 🥹 you can access it using the perldoc command, the man command, or by browsing CPAN.

---

not me writing a whole manual page and it's literally perl v5.42.0, dated 2025-07-25, shipped as part of Maypole...Install(3) under User Contributed Perl Documentation 💀 you're so welcome, bestie — go install some modules 🫶💖