Installing and operating

Convoro installed and the front page works, but every link 404s. Why? Your web server is not rewriting URLs, so only the front page ever reaches PHP. Convoro can work without rewriting — add <code>'URL_REWRITING' => 'off'</code> to <code>config/site.php</code> and every address will carry <code>index.php</code>. Turning rewriting on is the better fix, and this article says how. Administrators How do I install Convoro? Upload the zip, open the site in a browser and follow the installer. There is no Composer step, no build step and no shell required — you need PHP 8.5 and a MySQL database. Administrators How do I switch on the assistant that answers questions? Install the AI Assistant extension and put your Anthropic key in Admin → AI Assistant. It answers only from your Knowledge Base, so write the articles first — with none, it will correctly tell everybody that nothing is covered. Administrators I finished installing and it went back to the beginning. Why? A fault in the 1.0.0, 1.0.1 and 1.0.2 downloads, and in the first build of 1.0.3. Download 1.0.3 again and run the installer once more — your database is fine and nothing needs undoing first. Administrators Is there a .env file? Where is the database password? In config/site.php, a PHP file rather than a .env. A .php file is executed by the server; a .env is handed out as plain text by anything serving static files from the application root. Administrators The assistant keeps saying that is not covered. Is it broken? Almost always no. It answers only from published Knowledge Base articles, and saying so is what it is meant to do when none of them cover the question. Write the article and it will answer. Administrators Do I need to set up cron jobs? Convoro works without any, but three commands are worth scheduling: purchases:sweep if you sell anything, privacy:prune, and search:reindex if you use an external search backend. Administrators How do I make search better on a large community? Install the OpenSearch module, point it at your server in Admin → OpenSearch, and rebuild the index. MySQL stays the default and search falls back to it automatically if the server stops answering. Administrators My uploaded images work locally but 404 in production. Why? Your nginx configuration is serving anything ending in .png straight from disk, and Convoro serves uploads through PHP. Add a location block for the path — the list is in tools/deploy/nginx-paths-served-by-php.conf. Administrators What do I need to back up? The database, the content directory, config/site.php and any extensions you installed. The code itself you can re-download; those four you cannot. Administrators