ikiwiki

ikiwiki is a self-hosted wiki compiler for people who want to publish editable pages as a website rather than manage a hosted collaboration workspace. Its static output and flexible editing options are compelling, but opening a wiki to contributors means taking its security guidance seriously.

Overview

ikiwiki converts wiki pages into HTML and updates the generated site when source pages change. Page history can live in Git or Subversion, but revision control is optional. That makes it a good fit for personal publishing and sites where owners want control over the publishing setup; it is less suited to teams looking for a managed service.

The setup tutorial describes creating a working wiki with one command, while advanced users can configure a manual setup. Installation packages cover Debian or Ubuntu, Fedora, BSD, openSUSE, Arch Linux, Homebrew, and Guix. The project is developed by Joey and other contributors, with a forum, bug tracker, TODO list, and discussion pages for support.

Key features

Markdown is the default markup, and plugins can add WikiText, HTML, reStructuredText, or Textile. Plugins also extend directives, revision-control backends, and CGI functionality. That modularity lets owners shape a wiki around their workflow, but it also means the capabilities depend on the plugins and configuration they choose.

Any page can function as a blog and generate RSS or Atom feeds. Templates, CSS, and themes control the appearance of the generated pages, while Xapian can add full-text search. These options make ikiwiki useful for publishing varied site content, although configuring the desired mix is part of the owner's work.

Optional web editing supports registration, OpenID and HTTP Basic authentication, and configurable page edit controls. Owners can also choose revision-control-based editing. This is useful when contributors need browser access or a repository workflow, but the security guidance warns that allowing others to edit introduces risks, including around configuration and uploaded content. It notes that Perl taint checking is disabled in production builds because of a Perl bug, so public editing deserves particular care.

Pricing

ikiwiki is free software under the GNU GPL version 2 or later. The ikiwiki plan costs nothing, and there is no free trial because the software is free to use. There are no paid plans to weigh against the free version; the trade-off is that this is self-hosted software rather than a priced hosted service.

Platforms

ikiwiki supports Linux, macOS, self-hosting, and web access. It supports custom domains, single sign-on, and version history. Its installation packages span several Linux distributions, BSD, Homebrew, and Guix, giving technically capable owners multiple routes to a self-hosted installation.

Who it's for

Choose ikiwiki if you want a free, extensible publishing system and are comfortable owning the setup, appearance, and editing controls. It suits personal wikis, blogs, and sites whose maintainers want static HTML output with optional revision-control history. Look elsewhere if you need a hosted workspace or want to allow public contributions without taking responsibility for security configuration.

Pros and cons

• Static HTML publishing: Pages are generated as a website and updated when their source changes, a practical fit for owners focused on publishing.
• Flexible editing and history: Web editing and revision control are optional, so maintainers can choose the contribution model that suits the site.
• Extensible content tools: Plugins add markup formats, directives, backends, and CGI functionality; themes and templates shape the output.
• Security overhead for contributors: Enabling editing or uploads introduces risks that owners must mitigate, and production builds disable Perl taint checking.
• Self-hosting responsibility: Free software avoids plan costs, but setup and ongoing site administration remain with the owner.

Alternatives

TiddlyWiki is another free and open-source choice for readers who want support across Android, iOS, Windows, and other listed platforms. Confluence is worth considering for a team that wants a free hosted option with a stated limit of 10 users, 2 GB of file storage, and three active whiteboards per user.

Foswiki, MediaWiki, MoinMoin, PmWiki, Tiki Wiki CMS Groupware, and TWiki are other free, self-hosted wiki options. PmWiki requires PHP; TWiki requires web server administration.

Browse more options in Wiki Software or Knowledge base software.

Verdict

ikiwiki is a strong choice for technically capable site owners who want free wiki publishing with static output, optional history, and plugins to shape the workflow. Its main reason to choose it is that flexibility; its main reason to look elsewhere is the responsibility for self-hosting and securing contributor access.