Install TWiki on Different Platforms

TWiki is an enterprise Wiki that is quite portable to most systems that run Perl and have some key Unix tools (see TWikiSystemRequirements).

However, there can still be interesting installation issues, and it's useful to have somewhere to collect hints and tips - so just add a link here to a page on any new platform on which you install TWiki. Such pages can also be used to discuss packaging TWiki for easier installation on specific platforms.

Note: Some of these pages use packaged versions of TWiki - however, they may not always be up to date with TWikiProductionReleases and in particular TWikiSecurity updates. So check those pages to be aware of any post-install patching or upgrades.

See TWikiFor and TWikiDistributions for details of pre-packaged distributions and installers for different platforms.

Existing platforms (feel free to add your platform with tips on how to install):

• TWikiOnLinux - TWiki is used a lot on Linux and Apache - see ModPerlUnix for improved performance, and TWikiInstaller for easy installation on some Linux distributions
  • TWikiOnCentOS (Points to TWikiOnRedHat)
    • can use 4.2.0 TWikiInstaller
  • TWikiOnDebian - very easy, type one command to install
  • TWikiOnFedora (Points to TWikiOnRedHat)
  • TWikiOnGentoo
  • TWikiOnKubuntu - very easy, type one command to install - see also TWikiOnUbuntu
  • TWikiOnMandrake
  • TWikiOnRedHat - updated for TWiki4 - very detailed and also useful for other Linux distributions
    • can use 4.2.0 TWikiInstaller
  • TWikiOnSELinux
  • TWikiOnSuSE
  • TWikiOnUbuntu - very easy, type one command to install - see also TWikiOnKubuntu
  • TWikiOnPlaystation3 - through TWikiOnUbuntu on PS3
  • TWikiDevEnvColasNahaboo - system to manage installation and upgrades seamlessly with your local customisations. Intended for developers, on unix/linuxes.

• TWikiOnUnix - TWiki is also used quite a lot on Unix - see ModPerlUnix for improved performance
  • TWikiOnAIX
  • TWikiOnFreeBSD - TWiki is now in the FreeBSD ports system
  • TWikiOnHPUX
  • TWikiOnMainframe - on IBM's OS/390 and z/OS, via Unix APIs
  • TWikiOnMacOSX - MacOS X is Unix-based
  • TWikiOnNetBSD
  • TWikiOnSolaris
    • SolarisInstallCookbook
    • SolarisInstallCookbookPerlModules
    • SolarisInstallCookbookNtlm

• TWiki on webservers other than Apache:
  • TWikiOnLighttpd - on lighttpd webserver
    • TWikiOnLighttpdUsingFastCgi - on lighttpd webserver with FastCGI
  • TWikiOnThttpd - thttpd webserver
  • TWikiOnMemoryStick - using MicroWeb webserver
  • TWikiForWindowsPersonal - ready to run on Windows, for personal use, includes TinyWeb webserver
  • TWikiStandAlone - includes its own webserver and FastCGI support - good performance and reasonable memory use (beta level)

• TWikiOnVMS - Uses Apache and mod_perl on VMS - some patching required.

• Web hosting on Unix and Linux:
  • TWikiOnWebHostingSites - using Unix/Linux based web hosting sites
    • HostedTWikiRCSInstall, DreamhostSetupNotes, TWikiOnSharedGoDaddyHost, TWikiOnEmwdWebhost, TWikiOnWebHost1and1
  • TWikiOnSourceForge - for open source projects

• TWikiOnMacOSX - current version of MacOS
  • can use 4.2.0 TWikiInstaller for Mac OS X 10.4 (Tiger)
  • For Intel-based Macs, you should be able to use the existing TWikiVMDebianStable () - this is based on VMware for Mac OS (released in Aug 2006) to run TWikiOnLinux on top of MacOSX - much easier to install than normal TWiki installs, better TWiki performance, and full support for InternationalisationEnhancements

• TWiki on Windows - up to date and mainstream installation methods including for USB memory sticks - try these first!
  • can use 4.2.0 TWikiInstaller
  • DownloadTWikiVM - easy install of TWiki on Windows by using the free VMware Player - pre-configured TWiki server so much easier to install than WindowsInstallCookbook or IndigoPerlCookbook, and full support for InternationalisationEnhancements
  • TWikiForWindowsPersonal - for personal use, run from USB memory stick or install to hard drive - includes TinyWeb webserver
  • IndigoPerlCookbook describes how to install TWiki using the IndigoPerl apache+perl package. Most suitable for a "personal TWiki" e.g. on a laptop.
  • TWiki04x02WindowsInstallationGuide - rewrite of the old WindowsInstallCookbook for TWiki 4.2.x
  • ModPerlWindows and WindowsModPerlInstallCookbook - install with mod_perl for improved performance
  • if is also possible to install TWiki to run under IIS, though there are still outstanding issues. - see Basics of IIS6 troubleshooting if you want to help make it work well.

• Other Portable TWiki setups - installing TWiki on a USB memory stick (mostly on Windows)
  • TWikiOnMemoryStick - using MicroWeb webserver on USB memory stick (flash drive)
  • TWikiOnUniformServer - can be used on a USB memory stick (flash drive)
  • TWikiMiniWebServer - standalone web server for TWiki

• Older or niche Windows installation methods
  • Specific Windows topics
    • TWikiOnWindowsKnownConfigurations
    • TWikiOnWindowsUsingApache
    • TWikiOnCygwin - using CygWin on Windows
      • TWikiOnCygwinApacheScripts
  • Obsolete: WindowsInstallCookbook - for installation by hand using Apache and CygWin - official cookbook for TWiki 3 (01 Sep 2004 release) - see TWiki04x02WindowsInstallationGuide for a version that works for TWiki 4.2.x.
    • TWikiInstallerWindows
  • Obsolete topic: TWikiOnWindows

Less commonly used platforms, where TWiki most likely does not work (yet):

• TWikiOnNovellNetWare
• TWikiOnSymbian - used in smartphones and PDAs
• TWikiOnWindowsCE
  • TWikiOnIpaq
• TWikiOnPalm
  • see ViewTWikiOnPDA for read-only usage of TWiki pages (no Perl for Palm, but PalmOS will have a Linux-based variant in future)
• TWikiOnBeOS
• TWikiOnXBox

-- Contributors: BenWatts, CrawfordCurrie, FrankHorowitz, FranzJosefSilli, KennethLavrsen, PeterThoeny, RichardDonkin, SueBlake, SvenDowideit, ToddJonker, ZeljkoBlace