Kieren Diment > Catalyst-Manual-5.9005 > Catalyst::Manual::Deployment::SharedHosting

Download:
Catalyst-Manual-5.9005.tar.gz

Annotate this POD

CPAN RT

New  7
Open  2
View/Report Bugs
Source   Latest Release: Catalyst-Manual-5.9008

NAME ^

Catalyst::Manual::Deployment::SharedHosting - Deploying Catalyst on Shared Hosting

Catalyst on shared hosting ^

So, you want to put your Catalyst application out there for the whole world to see, but you don't want to break the bank. 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. First, run

    perl -MCPAN -e shell

and go through the standard CPAN configuration process. Then exit without installing anything. 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. 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.

syntax highlighting: