Bugs happen. We do our best to find them all but will inevitably miss some. Here’s the protocol to follow for when you think you might have found something that needs reporting.

Before You File a Bug Report

Before you file a bug, we ask that you put in the necessary time and research to ensure that what you are reporting is in fact a bonafide bug and not the result of some other configuration, operating system or application problem. To ensure your bug report is worth filing, please attempt do the following:

1. Search through the existing issues in Basho’s Bug Tracker. There are a lot of people using Riak and, as as result, chances are someone has run into the same issue and has reported it.
2. Search the Riak Mailing List Archives for similar issues and possible resolution paths. (The Mailman archives of the list archives can also be accessed here.)
3. Email the Riak Mailing List with your issue to see if there is a simple path to resolution.

Writing and Filing Your Bug Report

1. Go to issues.basho.com and select File a Bug.
2. Sign into Bugzilla. If you don’t have a Bugzilla account you can create one using the “create new account” link.
3. The next step is to read and familiarize yourself with the bug writing guidelines if you haven’t already. This set of instructions gives pointers and recommendations on how to actually write your bug report and lays out the actual steps to file a bug correctly.
4. After committing the guidelines to memory, go ahead and enter a new bug.. You’ll first be prompted to select the Basho project for which you want to enter a bug. Chances are you’ll be filing a bug pertaining to Riak, but you can also use this for related projects such as Luwak and Riak Search.
5. With the Bug Writing Guidelines as your… guide, fill out the bug report, add attachments as necessary, and click Submit Bug to complete the process.

If at any point you have a question about how to file a bug or think there is something fishy about this process, please use the Riak Mailing List.