Frequently Asked Questions
You have questions, we have answers. To save us answering the same questions over and over, we have compiled a short list of questions that we receive quite often. Please read this page to see if you can find the answer to your question. If you cannot find the answer you need, you might like to try the documentation pages as well. If the solution still doesn't find you, consider asking on the mailing list.
What happened to the assignees in 0.9.9.4?
In 0.9.9.4 you assign tasks to users by simply selecting them. The text field above the select box is for a quick-search within the box. If the users you need are not listed, you need to grant the users' groups the “show as assignees” permission either globally or on project level.
When...?
Don't ask questions starting with this word. We'd have to lie anyway.
After setup, all database tables are created but empty...no sample task and project, can't login.
Make sure you are using MySQL 4.0 or higher.
I've downloaded and extracted Flyspray, but when I attempt to open it in my browser, I only get a blank page with a "0" on it.
Delete the .htaccess file and try again.
I get a "404 file not found" error when I click on links!
Make sure that address_rewriting in flyspray.conf.php is set to “0”, or if mod_rewrite is available, rename htaccess.dist to .htaccess
Why can't I delete tasks?
Nothing should ever be deleted from any sort of issue/task/bug tracking system. It completely ruins any chance of having accurate reporting. In addition, most things in Flyspray are referenced by numbers. These numbers point to other database tables where that number is looked up for the name to display. If the record doesn't exist, there will be blank spots in the user interface when they are displayed. If that sounds too technical or confusing, just take our word for it that it's a Bad ThingTM.
Notifications don't work correctly!
For emails please make sure that you use a custom SMTP connection (admin toolbox) because the default mail() function which is used otherwise is not recommended. Using “localhost” without username nor password should work in most cases. For Jabber problems check Jabber in the manual.
Getting Flyspray and PHP to work on Windows/IIS
* Visit http://php.iis.net/ to setup PHP correctly.
* In any other case DO NOT use PHP in ISAPI mode
I can't add attachments!
Make sure that the attachments folder is writable and executable, index.html exists inside the folder, file_uploads is enabled in php.ini and min(memory_limit, post_max_size, upload_max_filesize) is not too low for your files in php.ini either.
I get Warning: preg_replace_callback() [function.preg-replace-callback]: Unknown modifier ‘|’
This is a bug on earlier versions, update to 0.9.9RC2 or later.
After upgrading to 0.9.9 I get strange special chars in comment texts, task details etc.!
Check the following bug for an SQL script that might help you: http://bugs.flyspray.org/task/1208
Redirection problems with lighttpd
Infinitive redirection
Try clearing your browser cache and cookies.
I get "Notice: Only variable references should be returned by reference in... "
Most probably you are running PHP 4.4.0+ and use the PHP Zend Optimizer (see phpinfo). This is a Zend Optimizer bug.
Solution: Use a newer Zend Optimizer version, e.g. ZendOptimizer-2.6.2 or later versions.
If you or your host is unwilling to disable or upgrade the Zend Optimizer to a fixed version or change the PHP version, there's a workaround. In php.ini replace:
zend_optimizer.optimization_level=15
with:
zend_optimizer.optimization_level=14
You can also just suppress all PHP warnings:
/* in index.php */ error_reporting(E_ALL &~ (E_NOTICE | E_WARNING)); // or ini_set('display_errors', 'Off');
Related links:
Flyspray seems to crash PHP/Apache I see "Segmentation Fault" or "Access violation" in my logs
We and some users had observed this behaviuor, caused almost certainly by PHP 4.x and/or accelerators/optimizer bugs, upgrading to PHP 5.1 or later solves the problem.