Troubleshooting

Learn how to solve common problems.

Problems during installation of a website

The following error messages can happen:

Datenstrom Yellow requires PHP 7.0 or higher

Install the current PHP version on your web server. You need PHP 7.0 or higher. On Linux it's best to use the package management of your Linux distribution, for Mac there is MAMP, for Windows there is XAMPP. It's recommended to use the latest PHP version. As soon as the website finds the required PHP version, the problem should be resolved.

Datenstrom Yellow requires PHP xxx extension

Install the missing PHP extension on your web server. You need curl gd mbstring zip. Please keep in mind that the web server and the command line may use different PHP versions. It's recommended to use the same PHP version. As soon as the website finds the required PHP extensions, the problem should be resolved.

Datenstrom Yellow requires rewrite rules

Check the configuration of your web server. The web server requires additional URL rewrite rules, but this depends very much on the web server and operating system you use. It's best to contact your web hosting provider. As soon as the web server forwards HTTP requests to the yellow.php, the problem should be resolved.

Datenstrom Yellow requires write access

Execute the command chmod -R a+rw * in the installation folder. You can also use your FTP application to give write permissions to all files. It's recommended to give write permissions to all files and folders in the installation folder. As soon as the website has sufficient write access in the system folder, the problem should be resolved.

Datenstrom Yellow requires htaccess file

Copy the supplied .htaccess file into the installation folder. Check if your FTP application has a setting to show all files. It sometimes happens that the .htaccess file was overlooked during installation. As soon as the missing configuration file has been copied into the installation folder, the problem should be resolved.

Datenstrom Yellow requires complete upload

Copy again all of the supplied files into the installation folder. Check if your FTP application shows an error message during upload. It sometimes happens that the data transfer was interrupted during upload. After all files have been copied into the installation folder, the problem should be resolved.

Problems after installation of a website

The following error messages can happen:

Login failed

The email or password is incorrect. This error message usually means that the password is incorrect. If you forgot your password, you can reset it. You can also create a new user account in a web browser and at the command line. Contact the webmaster if you keep having problems with your user account.

Can't write file

The file can not be written to the file system. Execute the command chmod -R a+rw * in the installation folder. You can also use your FTP application to give write permissions to all files. Sometimes a file syncing application is miss-configured. Contact the webmaster if you keep having problems with the file system.

Can't send email message

The email message can not be sent. You may have to configure the email address for outgoing messages, so that the email address contains your domain name. Sometimes the default email address doesn't work or the mail server is miss-configured. Contact the webmaster if this error message is displayed continuously.

Can't generate static page

The page in question is not supported in a static website. There are some technical limitations to what the static generator can do, for example the static generator can't generate an email contact form. Any page could theoretically be generated as a static page, but then you would need additional services to handle dynamic HTTP requests.

Can't connect to the update server

The software update is not possible. This error message usually means that there is no internet connection or that the internet access is blocked on the web server. If you have a web server with SSH access, you can check the internet connection. Execute the command curl -I https://datenstrom.se on the web server.

Datenstrom Yellow stopped with fatal error

The software has crashed. Activate the debug mode for more information. Very likely an extension is not working properly or is not up to date. As soon as the relevant extension has been updated, the problem should be resolved. Contact the webmaster if this error message is displayed continuously.

Problems with your web server

You need a web server that forwards HTTP requests to Datenstrom Yellow. It's best to contact your web hosting provider and have them check the configuration of your web server. The web server has to do three things. First it has to forward HTTP requests for non existing files/folders to the yellow.php. Second it has to block direct access to the content folder with an error page. Third it has to block direct access to the system folder with an error page. See privacy and example configuration.

Problems with your mail server

You need a mail server to send emails. It's best to contact your web hosting provider and ask if sendmail is enabled. When you have confirmed that sendmail is enabled, your next option is to configure the email for outgoing messages. Open file system/extensions/yellow-system.ini and change From. Configure an email address with your domain name, for example noreply@example.com. Sometimes the default email address doesn't work or the mail server is miss-configured. Learn more about system settings.

Problems with extensions

You can use the debug mode to investigate the cause of a problem or if you are curious about how Datenstrom Yellow works. To activate the debug mode on your website open file system/extensions/yellow-system.ini and change CoreDebugMode: 1. Additional information will be displayed on the screen and in the browser console. Depending on the debug mode, more or less information are shown. Learn more about debugging.

Do you have questions? Get help.