This is where announcements of new releases, features, and other news are posted. IkiWikiUsers are recommended to subscribe to this page's RSS feed.

RSS Add a new post titled:

ikiwiki 3.20150329 released with these changes. This is a security update fixing a cross-site scripting vulnerability.

[ Joey Hess ]

  • Fix NULL ptr deref on ENOMEM in wrapper. (Thanks, igli)

[ Simon McVittie ]

  • Really don't double-decode CGI submissions, even on Perl versions that bundle an old enough for that not to be a problem: the system might have a newer installed separately, like Fedora 20. (Closes: Debian bug #776181; thanks, Anders Kaseorg)
  • If neither timezone nor TZ is set, set both to :/etc/localtime if we're on a GNU system and that file exists, or GMT otherwise
  • t/inline.t: accept translations of "Add a new post titled:" (Closes: Debian bug #779365)
  • Consistently document command-line options as e.g. --refresh, not -refresh

[ Amitai Schlair ]

  • In VCS-committed anonymous comments, link to url.

[ Joey Hess ]

In addition, version 3.20141016.2 was released on the same day to backport the cross-site-scripting fix to Debian 8.

Posted Sun Mar 29 17:46:45 2015

ikiwiki 3.20150107 released with these changes

[ Joey Hess ]

  • Added ikiwiki-comment program.
  • Add missing build-depends on libcgi-formbuilder-perl, needed for t/relativity.t
  • openid: Stop suppressing the email field on the Preferences page.
  • Set Debian package maintainer to Simon McVittie as I'm retiring from Debian.

[ Simon McVittie ]

  • calendar: add calendar_autocreate option, with which ikiwiki --refresh can mostly supersede the ikiwiki-calendar command. Thanks, Louis Paternault
  • search: add more classes as a hook for CSS. Thanks, sajolida
  • core: generate HTML5 by default, but keep avoiding new elements like <section> that require specific browser support unless html5 is set to 1.
  • Tell mobile browsers to draw our pages in a device-sized viewport, not an 800-1000px viewport designed to emulate a desktop/laptop browser.
  • Add new responsive_layout option which can be set to 0 if your custom CSS only works in a large viewport.
  • style.css, actiontabs, blueview, goldtype, monochrome: adjust layout below 600px ("responsive layout") so that horizontal scrolling is not needed on smartphone browsers or other small viewports.
  • core: new libdirs option alongside libdir. Thanks, Louis Paternault

[ Amitai Schlair ]

  • core: log a debug message before waiting for the lock. Thanks, Mark Jason Dominus
  • build: in po/Makefile, use the same $(MAKE) as the rest of the build. Thanks, ttw
  • blogspam: use the 2.0 JSON API (the 1.0 XML-RPC API has been EOL'd). Closes: Debian bug #774441

[ Joey Hess ]

  • po: If msgmerge falls over on a problem po file, print a warning message, but don't let this problem crash ikiwiki entirely.
Posted Wed Jan 7 06:24:32 2015

ikiwiki 3.20141016 released with these changes

[ Joey Hess ]

  • Fix crash that can occur when only_committed_changes is set and a file is deleted from the underlay.

[ Simon McVittie ]

  • core: avoid dangerous use of CGI->param in list context, which led to a security flaw in Bugzilla; as far as we can tell, ikiwiki is not vulnerable to a similar attack, but it's best to be safe
  • core: new reverse_proxy option prevents ikiwiki from trying to detect how to make self-referential URLs by using the CGI environment variables, for instance when it's deployed behind a HTTP reverse proxy (Closes: Debian bug #745759)
  • core: the default User-Agent is now "ikiwiki/$version" to work around ModSecurity rules assuming that only malware uses libwww-perl
  • core: use protocol-relative URLs (e.g. // so that https stays on https and http stays on http, particularly if the html5 option is enabled
  • core: avoid mixed content when a https cgiurl links to http static pages on the same server (the static pages are assumed to be accessible via https too)
  • core: force the correct top URL in w3mmode
  • google plugin: Use search form
  • docwiki: replace Paypal and Flattr buttons with text links
  • comments: don't record the IP address in the wiki if the user is logged in via passwordauth or httpauth
  • templates: add ARIA roles to some page elements, if html5 is enabled. Thanks, Patrick
  • debian: build-depend on libmagickcore-6.q16-2-extra | libmagickcore-extra so we can thumbnail SVGs in the docwiki
  • debian: explicitly depend and build-depend on libcgi-pm-perl
  • debian: drop unused python-support dependency
  • debian: rename debian/link to debian/links so the intended symlinks appear
  • debian: fix some wrong paths in the copyright file
Posted Thu Oct 16 20:02:01 2014

ikiwiki 3.20140916 released with these changes

  • Don't double-decode CGI submissions with >= 2.53, fixing "Error: Cannot decode string with wide characters". Thanks, Antoine Beaupré
  • Avoid making trails depend on everything in the wiki by giving them a better way to sort the pages
  • Don't let users post comments that won't be displayed
  • Fix encoding of Unicode strings in Python plugins. Thanks, chrysn
  • Improve performance and correctness of the [[!if ]] directive
  • Let [[!inline rootpage=foo postform=no]] disable the posting form
  • Switch default [[!man ]] shortcut to Closes: #700322
  • Add UUID and TIME variables to edittemplate. Closes: #752827 Thanks, Jonathon Anderson
  • Display pages in linkmaps as their pagetitle (no underscore escapes). Thanks, chrysn
  • Fix aspect ratio when scaling small images, and add support for converting SVG and PDF graphics to PNG. Thanks, chrysn
    • suggest ghostscript (required for PDF-to-PNG thumbnailing) and libmagickcore-extra (required for SVG-to-PNG thumbnailing)
    • build-depend on ghostscript so the test for scalable images can be run
  • In the CGI wrapper, incorporate $config{ENV} into the environment before executing Perl code, so that PERL5LIB can point to a non-system-wide installation of IkiWiki. Thanks, Lafayette Chamber Singers Webmaster
  • filecheck: accept MIME types not containing ';'
  • autoindex: index files in underlays if the resulting pages aren't going to be committed. Closes: #611068
  • Add [[!templatebody ]] directive so template pages don't have to be simultaneously a valid template and valid HTML
  • Add smcv to Uploaders and release to Debian
Posted Tue Sep 16 06:16:59 2014

ikiwiki 3.20140831 released with these changes

  • Make --no-gettime work in initial build. Closes: #755075
Posted Sun Aug 31 17:21:43 2014

ikiwiki 3.20140815 released with these changes

  • Add google back to openid selector. Apparently this has gotten a stay of execution until April 2015. (It may continue to work until 2017.)
  • highlight: Add compatibility with highlight 3.18, while still supporting 3.9+. Closes: #757679 Thanks, David Bremner
  • highlight: Add support for multiple language definition directories Closes: #757680 Thanks, David Bremner
Posted Fri Aug 15 13:24:13 2014

ikiwiki-hosting is an interface on top of Ikiwiki to allow easy management of lots of ikiwiki sites. I developed it for Branchable, an Ikiwiki hosting provider. It has a powerful, scriptable command-line interface, and also includes special-purpose ikiwiki plugins for things like a user control panel.

To get a feel for it, here are some examples:

ikisite create --admin
ikisite branch
ikisite backup --stdout | ssh otherhost 'ikisite restore --stdin'

ikiwiki-hosting is free software, released under the AGPL. Its website: --Joey

Posted Thu Aug 5 17:44:47 2010

The domain has been moved to a new server. If you can see this, your DNS has already caught up and you are using the new server. By the way, the new server should be somewhat faster. --Joey

Posted Sat Dec 12 16:19:42 2009

Ikiwiki has reached version 3.0 and entered a new phase in its development cycle.

The 3.0 release of ikiwiki changes several defaults and finishes some transitions. You will need to modify your wikis to work with ikiwiki 3.0. A document explaining the process is available in upgrade to 3.0.

The highlights of the changes in version 3.0 include:

Thanks to the many contributors to ikiwiki 3.0, including:

Jelmer Vernooij, Recai Oktaş, William Uther, Simon McVittie, Axel Beckert, Bernd Zeimetz, Gabriel McManus, Paweł Tęcza, Peter Simons, Manoj Srivastava, Patrick Winnertz, Jeremie Koenig, Josh Triplett, thm, Michael Gold, Jason Blevins, Alexandre Dupas, Henrik Brix Andersen, Thomas Keller, Enrico Zini, intrigeri, Scott Bronson, Brian May, Adeodato Simó, Brian Downing, Nis Martensen. (And anyone I missed.)

Also, thanks to the users, bug submitters, and documentation wiki editors. Without you, ikiwiki would just be a little thing I use for my home page.


Posted Wed Dec 31 16:30:41 2008

Now you can use git to clone this wiki, and push your changes back, thanks to ikiwiki's new support for untrusted git push. Enjoy working on the wiki while offline! --Joey

Posted Fri Oct 24 16:08:36 2008

I've produced a code_swarm visualization of the first 2+ years of ikiwiki's commit history.


PS, while I'm posting links to videos, here's a video of a lightning talk about ikiwiki.



Interesting things to watch for:

  • Initial development of ikiwiki to the point it was getting web edits. (First 2 seconds of video!)
  • Introduction to plugin support, and later, plugin changes dominating code changes.
  • Introduction of openid support and the resulting swarm of openid commenters.
  • Switch to git, my name in the logs changes from "joey" to "Joey Hess", and there are more code commits directly from others.

Getting the commit log was tricky because every web commit is in there too, so it has to deal with things like IPs and openids. The code swarm script will munge the log to handle these, and it was configured with code swarm.config.

Video editing by kino, ffmpeg, ffmpeg2theora, and too many hours of pain.

Audio by the Punch Brothers.

Posted Fri Jul 11 09:58:19 2008

I was asked a good question today: How can a company find someone to work on ikiwiki? To help answer this question, I've set up a consultants page. If you might be interested in being paid to work on ikiwiki, please add your information to the page. --Joey

And here's the first company looking for an ikiwiki developer that I am aware of:

The TOVA Company, a small medical software and hardware company in Portland, Oregon, is looking for developers to add functionality to ikiwiki. We're looking for developers who are already familiar with ikiwiki development, including plugins, and who would be willing to work on a part-time, non-employee, project-based basis for each of the small features that we want. The features we're interested in would obviously be GPL'd, and released to the community (if they'll have them :) ). Please contact Andrew Greenberg (andrew@thetovacompany) if you're interested. Thanks!

Posted Thu Jun 12 16:34:18 2008

I've gone ahead and moved to the faster box mentioned on server speed. Most poll respondants felt the old box was fast enough, but it's getting a bit overloaded with other stuff.

If you can see this, you're seeing the new server. If not, your DNS server hasn't caught up yet. I'll keep the old server up for a while too and merge any changes across since git makes that bog-easy.

Please report any problems..

Posted Wed Mar 19 23:07:13 2008 has upgraded to the not yet released ikiwiki 2.30. This version of ikiwiki drops support for subscribing to commit mail notifications for pages. The idea is that you can subscribe to the new RecentChanges feed instead. (Or create your own custom feed of only the changes you're interested in, and subscribe to that.)

So if you were subscribed to mail notifications on here, you'll need to change how you keep track of changes. Please let me know if there are any missing features in the RecentChanges feeds.

Statically building the RecentChanges also has performance implications, I'll keep an eye on server speed..


Posted Tue Jan 29 19:48:01 2008

I've put together a short screencast that covers approximatly the first half of the setup document, and includes a demo of setting up a blog using ikiwiki.

.. And now I've added a second screencast. Note that this uses a script that is only available in the as yet unreleased ikiwiki version 2.15.


Posted Mon Nov 26 20:14:22 2007

I've started using git as ikiwiki's main repository. See download for repository locations.

Note that all the sha1sums have changed from those in previously published git repositories. Blame git-svnimport.

I hope that this will make it easier to maintain and submit patches for ikiwiki.


Posted Wed Oct 24 22:21:06 2007

Ikiwiki has reached version 2.0 and entered a new phase in its development cycle.

With the 2.0 release of ikiwiki, some major changes have been made to the default configuration:

  • The usedirs setting is enabled by default. This will break all URLs to wikis that did not have usedirs turned on before, unless you follow the procedure described at switching to usedirs or edit your setup file to turn usedirs off: usedirs => 0,
  • OpenID logins are now enabled by default, if the Net::OpenID::Consumer perl module is available. Password logins are also still enabled by default. If you like, you can turn either OpenID or password logins off via the disable_plugins setting.

An overview of changes in the year since the 1.0 release:

  • New improved URLs to pages via usedirs.
  • OpenID support, enabled by default.
  • Plugin interface added, with some 60 plugins available, greatly expanding the capabilities of ikiwiki.
  • Tags, atom feeds, and generally full-fledged blogging support.
  • Fully working utf8.
  • Optimisations, approximately 3.5 times as fast as version 1.0.
  • Improved scalability to large numbers of pages.
  • Improved scalable logo.
  • Support for additional revision control systems besides svn: git, tla, mercurial.
  • Some support for other markup languages than markdown: rst, textile.
  • Unit test suite, with more than 300 tests.
Posted Mon Apr 30 00:51:57 2007
Integrated issue tracking with Ikiwiki by Joey Hess is now available on (LinuxWorld's author contract also allows this article to become part of the project's documentation.) Learn how to use Ikiwiki inlining and PageSpecs for lightweight workflow. Joey also explains how having the BTS and docs in the project's revision control system can help users of distributed revision control systems keep bug tracking info in sync with code changes.
Posted Fri Apr 6 17:29:16 2007

Google has accepted ikiwiki as a mentoring organization for Summer of Code 2007.

See our Summer of Code page for projects.


Posted Thu Mar 15 06:55:18 2007

Quick poll: Do you feel that ikiwiki is fast enough on this server, or should I move it to my much beefier auxiliary server?

It's fast enough (80%)

It's too slow! (12%)

No opinion (8%)

Total votes: 50

If you have specifics on performance issues, you might mention them on the discussion page.

Ikiwiki is now hosted at Branchable.

Posted Tue Feb 20 06:40:02 2007

Ikiwiki now has an IRC channel: #ikiwiki on

The channel features live commit messages for CIA for changes to both ikiwiki's code and this wiki. Plus occasional talk about ikiwiki.

Thanks to JoshTriplett for making this happen.

Posted Tue Feb 20 06:11:01 2007
Ikiwiki has its own domain now, Update your links.
Posted Sun Feb 18 16:24:26 2007
After looking up and noticing that another 8 hours had passed, replying to people and hacking, I've added a TipJar page, in case anyone feels like tossing me a few bucks for ikiwiki. TIA! --Joey
Posted Fri Dec 29 03:05:57 2006

Ikiwiki in svn now has support for using OpenID, a decentralized authentication mechanism that allows you to have one login that you can use on a growing number of websites.

Traditional password-based logins are still supported, but I'm considering switching at least over to using only OpenID logins. That would mean blowing away all the currently registered users and their preferences. If you're active on this wiki, I suggest you log out and log back in, try out the OpenID signup process if you don't already have an OpenID, and see how OpenID works for you. And let me know your feelings about making such a switch. --Joey

Accept only OpenID for logins (51%)

Accept only password logins (14%)

Accept both (33%)

Total votes: 149
Posted Mon Nov 20 17:08:23 2006

Some people may consider ikiwiki's default look to be a bit plain. Someone on slashdot even suggested perhaps it uses html 1.0. (Yes, an ikiwiki site has survived its first slashdotting. With static html, that's not very hard..) While the default style is indeed plain, there's more fine-tuning going on than you might think, and it's actually all done with xhtml and style sheets.

Stefano Zacchiroli came up with the idea of adding a css market page where IkiWikiUsers can share style sheets that you've come up with for ikiwiki. This is a great idea and I encourage those of you who have customised stylesheets to post them.

I'm also always looking for minimalistic yet refined additions to the default style sheet, and always appreciate suggestions for it.


Posted Fri Sep 22 20:12:21 2006

By the way, some other pages with RSS feeds about ikiwiki include plugins, TODO and bugs.