create new tag
, view all tags

Installing TWiki on SuSE Linux

TWiki works out of the box with SuSE following the standard instructions. If you are upgrading to TWikiRelease01Sep2004 you can also use the UpgradeTWiki script.

-- MS - 14 Jun 2003
-- PeterThoeny - 20 Aug 2004


If you want a simpler installation (and maintenance of some things, easier backup of specific webs, potential for a simple distributed twiki, data and code separation) then take a look at the TWikiUnixInstaller page.

The TWiki installer...

  • Asks you questions about your system
    • If you type help in response to any question, you get help
  • Enforces basic "good permissions" security
  • Integrates with your apache config. (If you upgrade your SuSE distribution, simply run integrateWithApache.sh again, and bounce your webserver - if the upgrade modifies your httpd.conf)
  • Integrates with the Apache LDAP module provide in SuSE (since at least version 7)
  • Has been tested on SuSE 6.2, 6.4, 7.0, 7.1, 7.2, 7.3, 8.0, 8.1, 8.2. (As well as various Solaris & BSD versions with varying utility)
  • The public version currently requires the AthensRelease (Dec 2001 release), a version that works with BeijingRelease will be forthcoming very shortly. (And has a number of new nice things)
The aim of the TWikiUnixInstaller was to make TWiki fully installable from scratch in ~15-20 minutes. Under SuSE I generally achieve this smile

Why not RPM'd ? I use more than one form of Unix smile

I'll be keeping an eye on this page if people have questions.

-- MS - 14 Jun 2003

I've updated the installer for the latest release & uploaded it. Timed fastest install for someone who's done this lots of times is 65 seconds. Someone less skilled might take a little longer, but shouldn't be excessive.


  • Has only been tested on SuSE 8.2
  • Now tries to allow the user to configure some aspects of BetterDefaults, some of the installer's defaults are aimed at allowing PreCompiling using the GenHTMLAddon add-on to work better. You should note that the GenHTML add on is no longer supported and must support yourself if you use it.

-- MS - 29 Jun 2003

SuSE uses RPM packages. There is a standard CD distribution, and online update service. RPMs are usually obtained through RPM search.

SuSE 9.0 installs with Apache 2 by default, and hoops have to be jumped through to go back to 1.3

  Apache 1.3 Apache 2
conf scripts /etc/httpd/httpd.conf /etc/apache2/httpd.conf
logs /var/log/httpd/logs /var/log/apache2/logs

I usually install TWiki in /usr/local/twiki

-- CrawfordCurrie - 17 Aug 2004

OK, I am running SlES 9. And I can't get this thing working right. Got it running but not working correctly (ie can't add new web, new user) etc.. Can we get some better directions here. Like how is the cgi files being run by wwwroot work. What about the *,rcs in the documentation about?

-- JamesGolden - 26 Jul 2005


I have just completed an install of TWiki 4.2 rc1 on SLES 10 SP1. I am new to TWiki, but couldn't find any current Suse-specific instructions. So here is now I did it, hopefully someone else will find this useful. I have assumed familiarity with Suse Linux, and that you have root shell access.

First setup a base install of SLES with the web server role configured. This installs Apache2, PHP, Perl etc (remove PHP if you like).

Next you need to install some extra packages. I used zypper for this (zypper install [package name]), but obviously you could use Yast if you prefer:

  • apache2-mod_perl
  • rcs
While I believe apache2-mod_perl isn't strictly needed, it must be dependent on something that is because I had major problems without it. I didn't take the time to discover what that was, but I don't see any downside to simply installing the module!

Restart apache (service apache2 restart), download the .tgz distribution, and follow the supplied installation instructions. I installed it to /srv/www/twiki. When changing ownership, use wwwrun:www.

Perl is installed as part of the base system, but there are some extra modules that are useful. To install them, first start cpan and configure it (defaults should be fine). Then simply type install [module name]. Probably the most important one to install is Apache::Htpasswd. See the CGI Setup section of the configure script (http://hostname/twiki/bin/configure) for the list of perl modules that are used by TWiki.

-- AlexForbes - 04 Dec 2007

Alex, this must be a dumb question, but is CPAN a part of the base system too? Another one: to change ownership, is it correct to use root:root? Thanks

-- JuanLussich - 23 Jul 2008

The script cpan is part of the perl package on most Linux distros, I believe. Distros such as Ubuntu and Debian also package some popular CPAN packages under names such as libacme-foo-perl for Acme::Foo, but most CPAN packages are not distro packages.

root:root should work as an argument for chmod on any major Linux distro.

-- RichardDonkin - 28 Jul 2008

This is probably a bit late for you Juan, but the change of ownership I was referring to was the one in the twiki installation instructions. So if you followed those directions and changed ownership of your twiki installation to root:root, the web server probably wouldn't be able to read all the files it needs to run twiki, as the permissions script assumes that the owner of the files is the user running the web server (which on Suse is wwwrun).

And yep, as said above, cpan is part of the perl package.

As a side note, I've changed jobs and my new workplace isn't a Novell shop... Which means no more free SLES updates, so I'm now running twiki on CentOS!

-- AlexForbes - 22 Sep 2008

About SLES10 perl dependencies, there's a useful repository for Perl packages: http://download.opensuse.org/repositories/home:/driesverachtert/SLE_10/

I prefer packages, as it's easier to replicate installations...

-- CiroIriarte - 04 Mar 2009

Edit | Attach | Watch | Print version | History: r13 < r12 < r11 < r10 < r9 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r13 - 2009-03-04 - CiroIriarte
  • Learn about TWiki  
  • Download TWiki
This site is powered by the TWiki collaboration platform Powered by Perl Hosted by OICcam.com Ideas, requests, problems regarding TWiki? Send feedback. Ask community in the support forum.
Copyright © 1999-2018 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.