Installing Foswiki on BlueHost shared hosting
This is a step-by-step guide for installing Foswiki on BlueHosts
's shared hosting plan. It's been tested with Foswiki version 1.1.3.
This procedure needs testing and updates for Foswiki 2.0. There are significant changes. Please use the InstallationGuide
Things to have
- A shared hosting plan at BlueHost. They have only one plan, so you can't choose the wrong one.
- SSH shell access to the host. They will enable this only after you've requested it and sent them a scan of your photo ID.
- An SSH client. On Linux, this comes standard with almost every distro. On Windows, you can download PuTTY. All sample code you will see in this document, happens in an SSH session to your host, either at the command prompt or inside a text editor.
Things to know
- Basic operations in a TTY text editor. When you're logged into your host through SSH, you're in a Red Hat Linux command-line environment. Choose one of the available editors (
nano) as your favourite - if you haven't done so already - and make sure you get familiar with simple operations like save, find, replace.
- Conventions used in this tutorial. Some pieces of text will be shown in red. Wherever you see a red piece of text, you should not copy & paste it verbatim into your SSH session, but replace it with something that's specific to your situation:
- FULLPATHTOHOME: Replace this with the full path to your home directory. You can get to know the full path to
home by typing the following command in your SSH client:
[~]# echo $HOME
example.com: Replace this with your own domain name.
JoeAdmin: Replace this with the WikiUserName of your site's administrator. E.g.: your own WikiUserName.
Note that this is typically unnecessary
foswiki/pub/.htaccess, comment out the line:
php_flag engine off (disable it by putting a '#' in front)
Follow Bootstrap instructions in the InstallationGuide
Do NOT directly start with bin/configure!
- Click on the button "Save changes" in the bottom right corner.
- Fill out your password again and click on "Save changes"
- Enter the URL of your website in your browser:
- The front page of the installed Foswiki appears!
Protect the configure script
Not needed on Foswiki 2.0.
We will choose an Apache-level authentication method for securing the
configure script. Basically, we create a user inside Foswiki, and use Foswiki's
.htpasswd file to authenticate access to
foswiki/bin/.htaccess, there are two lines that contain:
AuthType Basic. One of these 2 is not commented out. Change that line into:
- Make sure
foswiki/bin/.htaccess is saved.
http://example.com/foswiki/bin/configure to check access control for the
configure script. Login as
configure script is now secured.