X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/a72c33c76c43471c3478ce8ab7d7bef299ec3af8..47d179802d5f78365fa7077ae64de35f2892a1e4:/doc/tips/nearlyfreespeech.mdwn diff --git a/doc/tips/nearlyfreespeech.mdwn b/doc/tips/nearlyfreespeech.mdwn index 7892e1617..435743bf9 100644 --- a/doc/tips/nearlyfreespeech.mdwn +++ b/doc/tips/nearlyfreespeech.mdwn @@ -2,6 +2,12 @@ provider with very cheap pay as you go pricing. Here's how to install ikiwiki there if you don't have a dedicated server. +Note that you can also follow these instructions, get your wiki set up on +NearlyFreeSpeech, and then use the [[plugins/Amazon_S3]] plugin to inject +the static web pages into Amazon S3. Then NearlyFreeSpeech will handle the +CGI, and S3 will handle the web serving. This might be a more cost effective, +scalable, or robust solution than using NearlyFreeSpeech alone. + ## Register for an account and set up a site After you [get an account](https://www.nearlyfreespeech.net/about/start.php), @@ -11,7 +17,7 @@ Mine is named `ikiwiki-test` and I used their DNS instead of getting my own, resulting in They gave me 2 cents free funding for signing up, which is enough to pay -for 10 megabytes of hosting, or about a thousand typical page views at +for 10 megabytes of bandwidth, or about a thousand typical page views, at their current rates. Plenty to decide if this is right for you. If it is, $5 might be a good starting amount of money to put in your account. @@ -36,14 +42,20 @@ Use `wget` to [[download]] the ikiwiki tarball. Then unpack it: ## Install perl modules -Use CPAN to install the perl modules it uses into your home directory: +As an optional step, you can use CPAN to install the perl modules ikiwiki +uses into your home directory. This should not be necessary, mostly, +because the system has most modules installed already. + +So, you might want to skip this step and come back to it later if ikiwiki +doesn't work. - PERL5LIB=ikiwiki:ikiwiki/cpan:. PERL_MM_USE_DEFAULT=1 perl -MCPAN -e 'CPAN::Shell->install("Bundle::IkiWiki")' - PERL5LIB=ikiwiki:ikiwiki/cpan:. PERL_MM_USE_DEFAULT=1 perl -MCPAN -e 'CPAN::Shell->force(install => "Bundle::IkiWiki::Extras")' + PERL5LIB=`pwd`/ikiwiki:`pwd`/ikiwiki/cpan:`pwd`/lib/perl5 PERL_MM_USE_DEFAULT=1 perl -MCPAN -e 'CPAN::Shell->install("Bundle::IkiWiki")' + + PERL5LIB=`pwd`/ikiwiki:`pwd`/ikiwiki/cpan:`pwd`/lib/perl5 PERL_MM_USE_DEFAULT=1 perl -MCPAN -e 'CPAN::Shell->force(install => "Bundle::IkiWiki::Extras")' -(This will take a while. As long as the first command succeeds, ikiwiki will be -usable. The second command adds extra modules that some plugins use, and -installation of some of them might fail.) +This will take a while. As long as the first command succeeds, ikiwiki will be +usable. The second command adds extra modules that some plugins use, so it's +ok if installation of some of them fail. ## Build and install ikiwiki @@ -53,7 +65,7 @@ installation of some of them might fail.) $MAKE $MAKE install -## Set up a wiki in the usual way. +## Set up a wiki in the usual way With ikiwiki installed, you can follow the regular [[setup]] tutorial for settng up your wiki. Make sure to set `destdir` to `/home/htdocs/` so that @@ -81,9 +93,14 @@ Here is an example of how I set up a wiki: ## Clean up Finally, you can save a _lot_ of disk space by cleaning up the ikiwiki -tarball and .cpan directory. +tarball and .cpan directory and a few other peices of cruft. Since you'll be +charged one cent per month per megabyte, this is a quick way to save several +dollars. + +rm -rf ~/ikiwiki*.tar.gz ~/.cpan ~/ikiwiki ~/man ~/lib/perl5/5.8.8 -rm -rf ~/ikiwiki*.tar.gz ~/.cpan +That should cut things down to less than 2 megabytes. If you want to save +even more space, delete unused perl modules from ~/lib/perl5 ## Enjoy!