Catalys...dHosting(3)

💖 NAME 💖

okay bestie, this is the Catalys...dHosting(3) page from the User Contributed Perl Documentation, and it’s here to help you deploy on shared hosting.

Catalyst::Manual::Deployment::SharedHosting — Deploying Catalyst on Shared Hosting.

🌸 Catalyst on shared hosting 🌸

So you wanna put your Catalyst application out there for the whole world to see, but you are not trying to break the bank? Bestie, there is an answer — if you can get shared hosting with FastCGI and a shell, you can install your Catalyst app in a local directory on your shared host. It’s giving budget-friendly main character energy, fr fr.

First, run:

perl -MCPAN -e shell

and go through the standard CPAN configuration process. Then exit without installing anything. Yes, literally just exit — not me leaving CPAN with zero modules installed, iconic.

Next, download the latest local::lib package and follow its 'bootstrap' instructions to get it installed and the local configuration added to your ~/.bashrc.

Now log out, then back in again (or run . .bashrc if you prefer). 🦋

Now you can install the modules you need using CPAN as normal; they will be installed into your local directory, and Perl will pick them up. Periodt. 💅

Finally, change into the root directory of your virtual host, and symlink your application's script directory:

cd path/to/mydomain.com
ln -s ~/lib/MyApp/script script

And add the following lines to your .htaccess file (assuming the server is setup to handle .pl as fcgi — you may need to rename the script to myapp_fastcgi.fcgi and/or use a SetHandler directive):

RewriteEngine On
RewriteCond %{REQUEST_URI} !^/?script/myapp_fastcgi.pl
RewriteRule ^(.*)$ script/myapp_fastcgi.pl/$1 [PT,L]

Now http://mydomain.com/ should now Just Work. Congratulations, now you can tell your friends about your new website. 💖✨

👑 AUTHORS 👑

Catalyst Contributors, see Catalyst.pm.

🎀 COPYRIGHT 🎀

This library is free software. You can redistribute it and/or modify it under the same terms as Perl itself.

---

And that’s the vibe check: this page came from perl v5.42.0 on 2024-03-23, with the footer looking like Catalys...dHosting(3). Bye bestie, go slay that deployment! 💜