I’m surprised about this. I’ve been posting on Twitter and Facebook how I was installing the Confluence at home and several people specifically asked me if I would blog about it. After running everything for a week, I’m finally ready to put it up.

So, what is a wiki (from wikipedia):

A wiki (pronounced /ˈwɪki/ WIK-ee) is a website that allows the easy^[1] creation and editing of any number of interlinked Web pages, using a simplified markup language or a WYSIWYG text editor, within the browser.^[2][3] Wikis are typically powered by wiki software. Wikis are often used to createcollaborative websites, to power community websites, for personal note taking, in corporate intranets, and in knowledge management systems.

We have used one at work for years and it’s an important tool for documentation and for keeping important things for a group out of someone’s email box. I’ve gotten to rely on it.  My wife has been working with a company and keeping notes on a running Word doc, and I’ve been really wanting to set up a wiki for at home.  The challenge was that I don’t think my wife is willing to learn wiki markup language while trying to work, so I needed something that was as easy to edit and create as Word is.  At work we’ve used Confluence, which is an enterprise class wiki.

What is Confluence?

Confluence is a simple, powerful wiki that lets you create and share pages, documents and rich content with your team.

If you’re looking for a better way to collaborate, Confluence has the essential enterprise features for your organisation.

But wait, you say… isn’t enterprise class software expensive?  Right, yes… you are correct.  But the company that makes Confluence offers a license that is palatable for the home users; they offer a 10 user license for $10 a year! You can’t beat that!

the setup

As you may or may not know from previous posts, I have an old FreeBSD box and a VMWare ESXi server on an old Dell 1850 in the basement. I created a new VM using CentOS 5.4.  I installed the latest JRE / Jaa from Sun on it and took off. It didn’t work out so smoothly. Here’s what I did to get everything working.

• I had to upgrade MySQL on my FreeBSD host to the latest to match the version of the JDBC driver onon the VM/Confluence server.
• I had to add an option to my MySQL startup so that I was able to update plugins.
  • mysql_args=”–max_allowed_packet=32M”
• By default, Confluence comes with a version of Tomcat and runs by default on port 8080. I used my router to remap that to 8000 so I had a modicum of extra security. http://my.wiki.com:8000/ <- nope, that ain’t really it!

So if you come any errors with your Confluence plugins, check this option for you mysqld.

now we’re running

So now we are running. Here’s what I did:

• Created a space for me, my wife, and our family.
• Created a user group for our family, and a group for the people she’s working with so I can get granular with the permissions
• Created a space for our family
  • Confluence has a plugin for Google Calendars. We have a family Google Calendar which now displays in the family space.
  • I also have an RSS feed for local weather and news

lessons learned

• Make sure ALL your versions match up
• If you are using IE8, to get the rich text editor, make sure you use Compatibly Mode.
• Have patience with your users. It’s a different way to think about documentation and collaboration.
• Be very helpful. Comment on the other spaces in positive ways.
• Learn the macros!
• Learrn about RSS
• TAG/LABEL all your posts!
• Every user must create “their personal space” for blog or news posts. <- allows quick-hit posts!

The performance on the VM is great. In fact it is better than I anticipated. If you were hard pressed you could probably run everything on a single host for just a family.  I love being able to display our Google Family calendar, (you can not edit it).

the result

We use it.  It is really handy and as long as we use it and it’s easy to edit and collaborate, we are in business. If you have questions, suggestions, or comments, let me know!