view release on metacpan or  search on metacpan

lib/Ado/Manual/Installation.pod  view on Meta::CPAN

  Successfully installed Ado-0.87 (upgraded from 0.86)
  1 distribution installed

  #or

  cpan Ado
  Running install for module 'Ado'
  Running make for B/BE/BEROV/Ado-0.85.tar.gz
  ...
  ...
    BEROV/Ado-0.85.tar.gz
  ./Build install install  -- OK

=head2 PERLBREW

Installing Ado under your own perlbrew environment

  perlbrew init
  perlbrew install -n perl-5.18.1 --as ado -j 3
  perlbrew switch ado
  perlbrew install-cpanm
  cpanm Ado

=head2 Carton

Installing Ado using Carton

  echo 'requires "Ado";' > cpanfile
  carton install
  carton exec local/bin/ado daemon

=head2 local::lib

Be warned that L<local::lib>, installed on some shared hosting providers'
machines, sets the environment variables  C<$PERL5LIB, $PERL_LOCAL_LIB_ROOT,
$PERL_MB_OPT, $PERL_MM_OPT>. If you are aware and expect Ado to be installed in
C<$PERL_LOCAL_LIB_ROOT> (usually C<~/perl5>) then fine. If you are using your
own Perl and not the provided on the machine, you have to reset those variables
while installing Ado. Otherwise you may be unpleasantly surprised. For
ActivePerl it may be best to install Ado dependencies using L<PPM>.  Ado is
available as L<PPM> package too.

  export PERL_MB_OPT='--install_base /home/you/example.com'
  #your own perl is already in $PATH and dependencies are installed
  perl Build.PL
  ./Build install

=head2 DUMMY

May be you want to just unwrap and run it...

  mkdir ~/ado && cd ~/ado && wget https://github.com/kberov/Ado/archive/v0.87.zip
  unzip v0.87.zip
  Ado-0.87/bin/ado daemon
  #Server available at http://127.0.0.1:3000

=head2 SUMMARY

Ado can be installed and deployed in many different ways. At the end it is
simply a Perl module which happen to be a Mojolicious application. For
inspiration, please read  L<Mojolicious::Guides::Cookbook/DEPLOYMENT> and maybe
try L<Ado::Command::generate::apache2htaccess>. Now you can follow the
instructions, found on the home-page
L<http://127.0.0.1:3000|http://127.0.0.1:3000>. But to grow with Ado, you should
install and create some plugins. See L<Ado::Manual::Plugins>.

=head1 SEE ALSO

L<Ado::Manual>, L<Ado>, L<Mojolicious::Guides>,
L<Module::Build::Cookbook/prefix_vs_install_base>

=head1 COPYRIGHT AND LICENSE

Copyright 2013-2015 Красимир Беров (Krasimir Berov).

This program is free software, you can redistribute it and/or
modify it under the terms of the
GNU Lesser General Public License v3 (LGPL-3.0).