Installing Foswiki on a Shared Host - Generic Guide
This guide provides generic steps for installing Foswiki on a typical shared host.
1. Get and unpack the Foswiki code
The Foswiki code can be obtained from the Download section
of the Foswiki home page.
If you have ssh-access to the web server, you can use
to download the file to the server, using something like:
Be sure to use the latest version!
Unpack the code:
tar xvzf Foswiki-2.0.1.tgz
2. Edit the
Copy the file
If your site uses cPanel, you might need to edit this file, and add a line
toward the top: Check any specific instructions from your hosting provider
(You might need to edit this later ... but try foswiki without this first!)
Set the absolute path to the Foswiki
by modifying the line
$foswikiLibPath = "/absolute/path/to/your/lib";
3. Create a
Not needed for Foswiki 2.0
.htpasswd file for configure
In a future step, a configure script will
be run to adapt the Foswiki settings to
match your system.
Accessing this configure script can only
be done when a user is granted access.
In this step we create this user.
to create a
directory. Navigate to the Foswiki
and issue the following at the command line
$ htpasswd -c .htpasswd admin_user_name
You will be prompted to enter (and confirm)
a password for the user. Obvious choices
but you can call it whatever you want (just remember that this is not a standard wiki user account name).
4. Copy and edit the appropriate
Each of the Foswiki directories (including the root directory)
file; these allow indeed a per-directory
configuration for the web server.
Templates for these
files are distributed with
Foswiki and can be found in the root directory. It concerns
root-htaccess.txt: should be copied to
pub-htaccess.txt: should be copied to
bin-htaccess.txt: should be copied to
subdir-htaccess.txt: should be copied to the remaining subdirectories (
For all these
files, chances are that the default
content is fine to get started. For the the
however, it is compulsory to edit
- the path to the Foswiki scripts directory
- the path to the Foswiki data directory
5. Proceed to your site with the expected view URL
Foswiki should come up and display the front page along with a blue banner stating that you are running in Bootstrap
Follow the InstallationGuide
for saving the configuration and creating your first user.