Setup

Requirements

Bikini requires Python 2.5+.

Setup

1. Copy all the files (including the hidden .htaccess file) in the root of your web site or in a sub-folder (e.g. “notes”). The folder must be script-writable;
2. make sure the file index.cgi is executable. If not, issue a chmod 755 index.cgi.
3. point your browser to the correct URI (e.g. http://yourserver.tld/notes/).

If everything has been set up correctly you should see a welcome FrontPage page.

Upgrading from previous versions

Important: NAV_NAMES setting changed format in version 1.1.0. You should update its value using the new format. Please refer to configuration.sample.py distribution file for an example.

The quickest way to upgrade Bikini is to do a fresh install on a new folder and then copy the pages and links folders from the older version. This way you get all the updated application files without the hassle to manually replace each file.

Customize

Customize your Bikini installation by copying or renaming configuration.sample.py file into configuration.py and change the settings as you wish. See Configuration for more details.

Protect pages

You can use Apache file-based authentication to protect Bikini pages to be edited from anonymous users. Put these directives in the Bikini .htaccess file.

Using HTTP digest authentication (more secure)

<IfModule mod_auth_digest.c>
    AuthType Digest
    AuthName "To save changes please log in first."
    AuthUserFile /path/to/.htpasswd
    <Limit POST PUT DELETE>
        Require valid-user
    </Limit>    
</IfModule>

Using HTTP basic authentication (less secure)

<IfModule mod_auth.c>
    AuthType Basic
    AuthName "To save changes please log in first."
    AuthUserFile /path/to/.htpasswd
    <Limit POST PUT DELETE>
        Require valid-user
    </Limit>    
</IfModule>

Please refer to Apache authentication tutorial for further information.