Welcome

Congratulations, you now have a working installation of iiFoswiki.

Basic Setup

Log in with the local admin account

Log in locally using the local administrator admin and the password stored in the INITIAL_ADMIN_PASSWORD environment variable

Configure Foswiki

Go to the configure page and configure various features of Foswiki.

Fresh installation

Please complete the installation and configuration by performing the steps outlined below.

Replace this topic with the front page for this website when done. Have a look at SitePreferences to see how to create a front page resembling the old front page of ETH websites.

Register Initial User

Register yourself as administrator using your ETH user account:

When done log out admin and log in again as yourself.

Preferences

Carefully look through WebPreferences and change the preferences as explained there.

Trash Web Preferences

Also edit Trash.WebPreferences to configure the Trash web used for deleted topics and attachments. Most of the settings can be copied over from WebPreferences.

Customize Topics

Make sure that all topics that are linked through the main and header navigation and footer links are there and contain meaningful information. The following topics are already present and should be edited, renamed or removed:

Do not forget to create and edit the topics and subtopics for the other links in the main navigation too.

Configure RSS Feeds

By default the RSS feed RssNews is enabled in WebPreferences which serves the first sub-section of the Main.News as feed item.

Migration

To migrate an existing iiTWiki to a new iiFoswiki forllow the steps below.

Backup iiTWiki

create a tar of the whole /var/www/twiki directory:

cd /var/www/
tar cf twiki.tar twiki

Copy twiki.tar to /var/www/foswiki on the new iiFoswiki.

Prepare the Migration

Extract twiki.tar and run the preparation script.

cd /var/www/foswiki
tar xf twiki.tar
cd twiki
../tools/iifoswiki_prep_migration.sh

Review any stray files.

Migrate

Run the migration script.

../tools/iifoswiki_migrate.sh

Page URL: https://isg-foswiki-test.inf.ethz.ch/bin/view/Main/WebHome
16 Oct 2026
© 2026 Eidgenössische Technische Hochschule Zürich