This page introduces you to the standard installation procedure. Some hosting provider-specific tutorials are available on this page.
Wanted! If you have installed Dotclear with a provider for which there is no tutorial, please feel free to contribute to the project by sending us your own tutorial, following the template, at documentation (at) dotclear.net.
Before installing Dotclear 2, you should check that your web space features the following technical capabilities:
Note:The GD2 php extension is useful, but it's not a requirement. If it's not present, you won't get image thumbnails in the media manager.
Tip:A script is available in the Hosting providers section for you to check that yours will support Dotclear.
Using Dotclear 2's automatic installer is the easiest way to install the blog engine. It will check that PHP 5 is enabled, and if it's not, it will activate it for you. Then the files required to install Dotclear will be downloaded. You will then be redirected to the standard installation wizard to complete the process.
To install Dotclear using the automatic installer:
If everything goes fine, you'll only have to click on the Next button to access the Installation Wizard. If you encounter any issues, you will have to use the "standard" method described below.
Note:Skip this step if you used the automatic installation.
You need to download Dotclear 2 archive, extract it then upload your files to your web space using an FTP client.
Important:If you want to be able to use the automatic update, configure your FTP client so the files are transfered in binary mode.
Check that the read, write and execute permissions of the following directories and files:
Tip:If you're on a Unix-based system, whether Linux or Mac, you can change the permissions to 777, i.e. read, write, and execute on all.
This solution will work but it provides less security. If you want to secure the permissions of your files and directories, please note that only the user and the server process need to have read, write, and execute permissions on these directories.
If you do not wish to create the config.php file yourself, you can use the configuration wizard. You simply need to go to http://www.angosso.net/dotclear/admin/install/. A message alerts you that you haven't got a configuration file and offers to run the wizard. Click this link.
You're presented with a form that asks you for some configuration information:
When you submit the form, the program checks that Dotclear's installation conditions are met, and if this is the case, the wizard takes you to the end of the installation process.
Rename inc/config.php.in into inc/config.php and fill in the values using the following indications:
If you're using SQLite, only fill the DC_DBNAME value field with the path to the SQLite database file.
Tip:You may also define the constants HTTP_PROXY_HOST and HTTP_PROXY_PORT that let you specify the host and port of a proxy that will be used for all HTTP operations (pings, trackbacks, RSS feed reading, etc.)
Tip:If you are using SQLite, create the database file specified by DC_DBNAME and make sure it's writable by the web server user (typically
Tip:_mail() function: you can override the function used to send mails. The default one uses the standard php mechanism (the mail() function). If you encounter difficulties sending mails, for example if the sent mails are too often stopped by antispam filters, we recommend you to configure the mail sending functionality. For more on the subject, please refer to: Customizing mail sending
After you have created the inc/config.php file, you only need to go to http://www.example.com/admin/install/ and answer the questions asked on this page. You will then get your password (a copy will be sent to you by email). Now all you have to do is start blogging :)
Important:You may be prompted a message telling you that the cache directory is not writable. In this case, change the value of DC_TPL_CACHE in your configuration file or give the necessary permissions to the relevant directory.
Note:The hosting provider-specific installation process is detailed in the Hosting providers section of this guide.
If you are managing several blogs with this installation, please refer to the multiblog documentation.
After finishing the installation procedure, don't forget to configure your blog settings.
See http://hg.dotclear.org/ for information about Dotclear repository
If you wish to use PHP files instead of gettext language files, create them manually by starting the build-tools/make-l10n.php program from the root of your Dotclear copy. Don't forget to do it after every update if you want to keep a translation updated.