Same filename and directory in other branches
  1. 10 INSTALL.txt
  2. 4.6.x INSTALL.txt
  3. 4.7.x INSTALL.txt
  4. 5.x INSTALL.txt
  5. 6.x INSTALL.txt
  6. 8.9.x INSTALL.txt
  7. 9 INSTALL.txt
CONTENTS OF THIS FILE
---------------------

 * Requirements and notes
 * Optional server requirements
 * Installation
 * Building and customizing your site
 * Multisite configuration
 * More information

REQUIREMENTS AND NOTES
----------------------

Drupal requires:

- A web server. Apache (version 2.0 or greater) is recommended.
- PHP 5.6 (at least, PHP 8.x or greater recommended) (https://www.php.net/).
- One of the following databases:
  - MySQL 5.5 (or greater) (https://www.mysql.com/) or equivalent versions of a
    compatible database such as MariaDB or Percona.
  - PostgreSQL 9.5 (or greater) (https://www.postgresql.org/).
  - SQLite 3.27 (or greater) (https://www.sqlite.org/).

Note that version numbers above represent the minimum versions that Drupal 7 is
routinely tested with. For more detailed information about compatibility with
newer versions (that benefit from support from their maintainers), and
requirements including a list of PHP extensions and configurations that are
required, see "System requirements"
(https://www.drupal.org/docs/7/system-requirements) in the Drupal.org online
documentation.

For detailed information on how to configure a test server environment using a
variety of operating systems and web servers, see "Local server setup"
(http://drupal.org/node/157602) in the Drupal.org online documentation.

Note that all directories mentioned in this document are always relative to the
directory of your Drupal installation, and commands are meant to be run from
this directory (except for the initial commands that create that directory).

OPTIONAL SERVER REQUIREMENTS
----------------------------

- If you want to use Drupal's "Clean URLs" feature on an Apache web server, you
  will need the mod_rewrite module and the ability to use local .htaccess
  files. For Clean URLs support on IIS, see "Clean URLs with IIS"
  (http://drupal.org/node/3854) in the Drupal.org online documentation.

- If you plan to use XML-based services such as RSS aggregation, you will need
  PHP's XML extension. This extension is enabled by default on most PHP
  installations.

- To serve gzip compressed CSS and JS files on an Apache web server, you will
  need the mod_headers module and the ability to use local .htaccess files.

- Some Drupal functionality (e.g., checking whether Drupal and contributed
  modules need updates, RSS aggregation, etc.) require that the web server be
  able to go out to the web and download information. If you want to use this
  functionality, you need to verify that your hosting provider or server
  configuration allows the web server to initiate outbound connections. Most web
  hosting setups allow this.

INSTALLATION
------------

1. Download and extract Drupal.

   You can obtain the latest Drupal release from http://drupal.org -- the files
   are available in .tar.gz and .zip formats and can be extracted using most
   compression tools.

   To download and extract the files, on a typical Unix/Linux command line, use
   the following commands (assuming you want version x.y of Drupal in .tar.gz
   format):

     wget http://drupal.org/files/projects/drupal-x.y.tar.gz
     tar -zxvf drupal-x.y.tar.gz

   This will create a new directory drupal-x.y/ containing all Drupal files and
   directories. Then, to move the contents of that directory into a directory
   within your web server's document root or your public HTML directory,
   continue with this command:

     mv drupal-x.y/* drupal-x.y/.htaccess /path/to/your/installation

2. Optionally, download a translation.

   By default, Drupal is installed in English, and further languages may be
   installed later. If you prefer to install Drupal in another language
   initially:

   - Download a translation file for the correct Drupal version and language
     from the translation server: http://localize.drupal.org/translate/downloads

   - Place the file into your installation profile's translations directory.
     For instance, if you are using the Standard installation profile,
     move the .po file into the directory:

       profiles/standard/translations/

   For detailed instructions, visit http://drupal.org/localize

3. Create the Drupal database.

   Because Drupal stores all site information in a database, you must create
   this database in order to install Drupal, and grant Drupal certain database
   privileges (such as the ability to create tables). For details, consult
   INSTALL.mysql.txt, INSTALL.pgsql.txt, or INSTALL.sqlite.txt. You may also
   need to consult your web hosting provider for instructions specific to your
   web host.

   Take note of the username, password, database name, and hostname as you
   create the database. You will enter this information during the install.

4. Run the install script.

   To run the install script, point your browser to the base URL of your
   website (e.g., http://www.example.com).

   You will be guided through several screens to set up the database, add the
   site maintenance account (the first user, also known as user/1), and provide
   basic web site settings.

   During installation, several files and directories need to be created, which
   the install script will try to do automatically. However, on some hosting
   environments, manual steps are required, and the install script will tell
   you that it cannot proceed until you fix certain issues. This is normal and
   does not indicate a problem with your server.

   The most common steps you may need to perform are:

   a. Missing files directory.

      The install script will attempt to create a file storage directory in
      the default location at sites/default/files (the location of the files
      directory may be changed after Drupal is installed).

      If auto-creation fails, you can make it work by changing permissions on
      the sites/default directory so that the web server can create the files
      directory within it for you. (If you are creating a multisite
      installation, substitute the correct sites directory for sites/default;
      see the Multisite Configuration section of this file, below.)

      For example, on a Unix/Linux command line, you can grant everyone
      (including the web server) permission to write to the sites/default
      directory with this command:

        chmod a+w sites/default

      Be sure to set the permissions back after the installation is finished!
      Sample command:

        chmod go-w sites/default

      Alternatively, instead of allowing the web server to create the files
      directory for you as described above, you can create it yourself. Sample
      commands from a Unix/Linux command line:

        mkdir sites/default/files
        chmod a+w sites/default/files

   b. Missing settings file.

      Drupal will try to automatically create a settings.php configuration file,
      which is normally in the directory sites/default (to avoid problems when
      upgrading, Drupal is not packaged with this file). If auto-creation fails,
      you will need to create this file yourself, using the file
      sites/default/default.settings.php as a template.

      For example, on a Unix/Linux command line, you can make a copy of the
      default.settings.php file with the command:

        cp sites/default/default.settings.php sites/default/settings.php

      Next, grant write privileges to the file to everyone (including the web
      server) with the command:

        chmod a+w sites/default/settings.php

      Be sure to set the permissions back after the installation is finished!
      Sample command:

        chmod go-w sites/default/settings.php

   c. Write permissions after install.

      The install script will attempt to write-protect the settings.php file and
      the sites/default directory after saving your configuration. If this
      fails, you will be notified, and you can do it manually. Sample commands
      from a Unix/Linux command line:

        chmod go-w sites/default/settings.php
        chmod go-w sites/default

5. Verify that the site is working.

   When the install script finishes, you will be logged in with the site
   maintenance account on a "Welcome" page. If the default Drupal theme is not
   displaying properly and links on the page result in "Page Not Found" errors,
   you may be experiencing problems with clean URLs. Visit
   http://drupal.org/getting-started/clean-urls to troubleshoot.

6. Change file system storage settings (optional).

   The files directory created in step 4 is the default file system path used to
   store all uploaded files, as well as some temporary files created by
   Drupal. After installation, you can modify the file system path to store
   uploaded files in a different location.

   It is not necessary to modify this path, but you may wish to change it if:

   - Your site runs multiple Drupal installations from a single codebase (modify
     the file system path of each installation to a different directory so that
     uploads do not overlap between installations).

   - Your site runs on a number of web servers behind a load balancer or reverse
     proxy (modify the file system path on each server to point to a shared file
     repository).

   - You want to restrict access to uploaded files.

   To modify the file system path:

   a. Ensure that the new location for the path exists and is writable by the
      web server. For example, to create a new directory named uploads and grant
      write permissions, use the following commands on a Unix/Linux command
      line:

        mkdir uploads
        chmod a+w uploads

   b. Navigate to Administration > Configuration > Media > File system, and
      enter the desired path. Note that if you want to use private file storage,
      you need to first enter the path for private files and save the
      configuration, and then change the "Default download method" setting and
      save again.

   Changing the file system path after files have been uploaded may cause
   unexpected problems on an existing site. If you modify the file system path
   on an existing site, remember to copy all files from the original location
   to the new location.

7. Revoke documentation file permissions (optional).

   Some administrators suggest making the documentation files, especially
   CHANGELOG.txt, non-readable so that the exact version of Drupal you are
   running is slightly more difficult to determine. If you wish to implement
   this optional security measure, from a Unix/Linux command line you can use
   the following command:

     chmod a-r CHANGELOG.txt

   Note that the example only affects CHANGELOG.txt. To completely hide all
   documentation files from public view, repeat this command for each of the
   Drupal documentation files in the installation directory, substituting the
   name of each file for CHANGELOG.txt in the example.

   For more information on setting file permissions, see "Modifying Linux,
   Unix, and Mac file permissions" (http://drupal.org/node/202483) or
   "Modifying Windows file permissions" (http://drupal.org/node/202491) in the
   Drupal.org online documentation.

8. Set up independent "cron" maintenance jobs.

   Many Drupal modules have tasks that must be run periodically, including the
   Search module (building and updating the index used for keyword searching),
   the Aggregator module (retrieving feeds from other sites), and the System
   module (performing routine maintenance and pruning of database tables). These
   tasks are known as "cron maintenance tasks", named after the Unix/Linux
   "cron" utility.

   When you install Drupal, its built-in cron feature is enabled, which
   automatically runs the cron tasks periodically, triggered by people visiting
   pages of your site. You can configure the built-in cron feature by navigating
   to Administration > Configuration > System > Cron.

   It is also possible to run the cron tasks independent of site visits; this is
   recommended for most sites. To do this, you will need to set up an automated
   process to visit the page cron.php on your site, which executes the cron
   tasks.

   The URL of the cron.php page requires a "cron key" to protect against
   unauthorized access. Your site's cron key is automatically generated during
   installation and is specific to your site. The full URL of the page, with the
   cron key, is available in the "Cron maintenance tasks" section of the Status
   report page at Administration > Reports > Status report.

   As an example for how to set up this automated process, you can use the
   crontab utility on Unix/Linux systems. The following crontab line uses the
   wget command to visit the cron.php page, and runs each hour, on the hour:

   0 * * * * wget -O - -q -t 1 http://example.com/cron.php?cron_key=YOURKEY

   Replace the text "http://example.com/cron.php?cron_key=YOURKEY" in the
   example with the full URL displayed under "Cron maintenance tasks" on the
   "Status report" page.

   More information about cron maintenance tasks is available at
   http://drupal.org/cron, and sample cron shell scripts can be found in the
   scripts/ directory. (Note that these scripts must be customized like the
   above example, to add your site-specific cron key and domain name.)

BUILDING AND CUSTOMIZING YOUR SITE
----------------------------------

A new installation of Drupal defaults to a very basic configuration. To extend
your site, you use "modules" and "themes". A module is a plugin that adds
functionality to Drupal, while a theme changes the look of your site. The core
of Drupal provides several optional modules and themes, and you can download
more at http://drupal.org/project/modules and http://drupal.org/project/themes

Do not mix downloaded or custom modules and themes with Drupal's core modules
and themes. Drupal's modules and themes are located in the top-level modules and
themes directories, while the modules and themes you add to Drupal are normally
placed in the sites/all/modules and sites/all/themes directories. If you run a
multisite installation, you can also place modules and themes in the
site-specific directories -- see the Multisite Configuration section, below.

Never edit Drupal's core modules and themes; instead, use the hooks available in
the Drupal API. To modify the behavior of Drupal, develop a module as described
at http://drupal.org/developing/modules. To modify the look of Drupal, create a
subtheme as described at http://drupal.org/node/225125, or a completely new
theme as described at http://drupal.org/documentation/theme

MULTISITE CONFIGURATION
-----------------------

A single Drupal installation can host several Drupal-powered sites, each with
its own individual configuration.

Additional site configurations are created in subdirectories within the 'sites'
directory. Each subdirectory must have a 'settings.php' file, which specifies
the configuration settings. The easiest way to create additional sites is to
copy the 'default' directory and modify the 'settings.php' file as appropriate.
The new directory name is constructed from the site's URL. The configuration for
www.example.com could be in 'sites/example.com/settings.php' (note that 'www.'
should be omitted if users can access your site at http://example.com/).

Sites do not have to have a different domain. You can also use subdomains and
subdirectories for Drupal sites. For example, example.com, sub.example.com, and
sub.example.com/site3 can all be defined as independent Drupal sites. The setup
for a configuration such as this would look like the following:

  sites/default/settings.php
  sites/example.com/settings.php
  sites/sub.example.com/settings.php
  sites/sub.example.com.site3/settings.php

When searching for a site configuration (for example www.sub.example.com/site3),
Drupal will search for configuration files in the following order, using the
first configuration it finds:

  sites/www.sub.example.com.site3/settings.php
  sites/sub.example.com.site3/settings.php
  sites/example.com.site3/settings.php
  sites/www.sub.example.com/settings.php
  sites/sub.example.com/settings.php
  sites/example.com/settings.php
  sites/default/settings.php

If you are installing on a non-standard port, the port number is treated as the
deepest subdomain. For example: http://www.example.com:8080/ could be loaded
from sites/8080.www.example.com/. The port number will be removed according to
the pattern above if no port-specific configuration is found, just like a real
subdomain.

Each site configuration can have its own site-specific modules and themes in
addition to those installed in the standard 'modules' and 'themes' directories.
To use site-specific modules or themes, simply create a 'modules' or 'themes'
directory within the site configuration directory. For example, if
sub.example.com has a custom theme and a custom module that should not be
accessible to other sites, the setup would look like this:

  sites/sub.example.com/
    settings.php
    themes/custom_theme
    modules/custom_module

NOTE: for more information about multiple virtual hosts or the configuration
settings, consult http://drupal.org/getting-started/6/install/multi-site

For more information on configuring Drupal's file system path in a multisite
configuration, see step 6 above.

MORE INFORMATION
----------------

- See the Drupal.org online documentation:
  http://drupal.org/documentation

- For a list of security announcements, see the "Security advisories" page at
  http://drupal.org/security (available as an RSS feed). This page also
  describes how to subscribe to these announcements via e-mail.

- For information about the Drupal security process, or to find out how to
  report a potential security issue to the Drupal security team, see the
  "Security team" page at http://drupal.org/security-team

- For information about the wide range of available support options, visit
  http://drupal.org and click on Community and Support in the top or bottom
  navigation.

File

INSTALL.txt
View source
  1. CONTENTS OF THIS FILE
  2. ---------------------
  3. * Requirements and notes
  4. * Optional server requirements
  5. * Installation
  6. * Building and customizing your site
  7. * Multisite configuration
  8. * More information
  9. REQUIREMENTS AND NOTES
  10. ----------------------
  11. Drupal requires:
  12. - A web server. Apache (version 2.0 or greater) is recommended.
  13. - PHP 5.6 (at least, PHP 8.x or greater recommended) (https://www.php.net/).
  14. - One of the following databases:
  15. - MySQL 5.5 (or greater) (https://www.mysql.com/) or equivalent versions of a
  16. compatible database such as MariaDB or Percona.
  17. - PostgreSQL 9.5 (or greater) (https://www.postgresql.org/).
  18. - SQLite 3.27 (or greater) (https://www.sqlite.org/).
  19. Note that version numbers above represent the minimum versions that Drupal 7 is
  20. routinely tested with. For more detailed information about compatibility with
  21. newer versions (that benefit from support from their maintainers), and
  22. requirements including a list of PHP extensions and configurations that are
  23. required, see "System requirements"
  24. (https://www.drupal.org/docs/7/system-requirements) in the Drupal.org online
  25. documentation.
  26. For detailed information on how to configure a test server environment using a
  27. variety of operating systems and web servers, see "Local server setup"
  28. (http://drupal.org/node/157602) in the Drupal.org online documentation.
  29. Note that all directories mentioned in this document are always relative to the
  30. directory of your Drupal installation, and commands are meant to be run from
  31. this directory (except for the initial commands that create that directory).
  32. OPTIONAL SERVER REQUIREMENTS
  33. ----------------------------
  34. - If you want to use Drupal's "Clean URLs" feature on an Apache web server, you
  35. will need the mod_rewrite module and the ability to use local .htaccess
  36. files. For Clean URLs support on IIS, see "Clean URLs with IIS"
  37. (http://drupal.org/node/3854) in the Drupal.org online documentation.
  38. - If you plan to use XML-based services such as RSS aggregation, you will need
  39. PHP's XML extension. This extension is enabled by default on most PHP
  40. installations.
  41. - To serve gzip compressed CSS and JS files on an Apache web server, you will
  42. need the mod_headers module and the ability to use local .htaccess files.
  43. - Some Drupal functionality (e.g., checking whether Drupal and contributed
  44. modules need updates, RSS aggregation, etc.) require that the web server be
  45. able to go out to the web and download information. If you want to use this
  46. functionality, you need to verify that your hosting provider or server
  47. configuration allows the web server to initiate outbound connections. Most web
  48. hosting setups allow this.
  49. INSTALLATION
  50. ------------
  51. 1. Download and extract Drupal.
  52. You can obtain the latest Drupal release from http://drupal.org -- the files
  53. are available in .tar.gz and .zip formats and can be extracted using most
  54. compression tools.
  55. To download and extract the files, on a typical Unix/Linux command line, use
  56. the following commands (assuming you want version x.y of Drupal in .tar.gz
  57. format):
  58. wget http://drupal.org/files/projects/drupal-x.y.tar.gz
  59. tar -zxvf drupal-x.y.tar.gz
  60. This will create a new directory drupal-x.y/ containing all Drupal files and
  61. directories. Then, to move the contents of that directory into a directory
  62. within your web server's document root or your public HTML directory,
  63. continue with this command:
  64. mv drupal-x.y/* drupal-x.y/.htaccess /path/to/your/installation
  65. 2. Optionally, download a translation.
  66. By default, Drupal is installed in English, and further languages may be
  67. installed later. If you prefer to install Drupal in another language
  68. initially:
  69. - Download a translation file for the correct Drupal version and language
  70. from the translation server: http://localize.drupal.org/translate/downloads
  71. - Place the file into your installation profile's translations directory.
  72. For instance, if you are using the Standard installation profile,
  73. move the .po file into the directory:
  74. profiles/standard/translations/
  75. For detailed instructions, visit http://drupal.org/localize
  76. 3. Create the Drupal database.
  77. Because Drupal stores all site information in a database, you must create
  78. this database in order to install Drupal, and grant Drupal certain database
  79. privileges (such as the ability to create tables). For details, consult
  80. INSTALL.mysql.txt, INSTALL.pgsql.txt, or INSTALL.sqlite.txt. You may also
  81. need to consult your web hosting provider for instructions specific to your
  82. web host.
  83. Take note of the username, password, database name, and hostname as you
  84. create the database. You will enter this information during the install.
  85. 4. Run the install script.
  86. To run the install script, point your browser to the base URL of your
  87. website (e.g., http://www.example.com).
  88. You will be guided through several screens to set up the database, add the
  89. site maintenance account (the first user, also known as user/1), and provide
  90. basic web site settings.
  91. During installation, several files and directories need to be created, which
  92. the install script will try to do automatically. However, on some hosting
  93. environments, manual steps are required, and the install script will tell
  94. you that it cannot proceed until you fix certain issues. This is normal and
  95. does not indicate a problem with your server.
  96. The most common steps you may need to perform are:
  97. a. Missing files directory.
  98. The install script will attempt to create a file storage directory in
  99. the default location at sites/default/files (the location of the files
  100. directory may be changed after Drupal is installed).
  101. If auto-creation fails, you can make it work by changing permissions on
  102. the sites/default directory so that the web server can create the files
  103. directory within it for you. (If you are creating a multisite
  104. installation, substitute the correct sites directory for sites/default;
  105. see the Multisite Configuration section of this file, below.)
  106. For example, on a Unix/Linux command line, you can grant everyone
  107. (including the web server) permission to write to the sites/default
  108. directory with this command:
  109. chmod a+w sites/default
  110. Be sure to set the permissions back after the installation is finished!
  111. Sample command:
  112. chmod go-w sites/default
  113. Alternatively, instead of allowing the web server to create the files
  114. directory for you as described above, you can create it yourself. Sample
  115. commands from a Unix/Linux command line:
  116. mkdir sites/default/files
  117. chmod a+w sites/default/files
  118. b. Missing settings file.
  119. Drupal will try to automatically create a settings.php configuration file,
  120. which is normally in the directory sites/default (to avoid problems when
  121. upgrading, Drupal is not packaged with this file). If auto-creation fails,
  122. you will need to create this file yourself, using the file
  123. sites/default/default.settings.php as a template.
  124. For example, on a Unix/Linux command line, you can make a copy of the
  125. default.settings.php file with the command:
  126. cp sites/default/default.settings.php sites/default/settings.php
  127. Next, grant write privileges to the file to everyone (including the web
  128. server) with the command:
  129. chmod a+w sites/default/settings.php
  130. Be sure to set the permissions back after the installation is finished!
  131. Sample command:
  132. chmod go-w sites/default/settings.php
  133. c. Write permissions after install.
  134. The install script will attempt to write-protect the settings.php file and
  135. the sites/default directory after saving your configuration. If this
  136. fails, you will be notified, and you can do it manually. Sample commands
  137. from a Unix/Linux command line:
  138. chmod go-w sites/default/settings.php
  139. chmod go-w sites/default
  140. 5. Verify that the site is working.
  141. When the install script finishes, you will be logged in with the site
  142. maintenance account on a "Welcome" page. If the default Drupal theme is not
  143. displaying properly and links on the page result in "Page Not Found" errors,
  144. you may be experiencing problems with clean URLs. Visit
  145. http://drupal.org/getting-started/clean-urls to troubleshoot.
  146. 6. Change file system storage settings (optional).
  147. The files directory created in step 4 is the default file system path used to
  148. store all uploaded files, as well as some temporary files created by
  149. Drupal. After installation, you can modify the file system path to store
  150. uploaded files in a different location.
  151. It is not necessary to modify this path, but you may wish to change it if:
  152. - Your site runs multiple Drupal installations from a single codebase (modify
  153. the file system path of each installation to a different directory so that
  154. uploads do not overlap between installations).
  155. - Your site runs on a number of web servers behind a load balancer or reverse
  156. proxy (modify the file system path on each server to point to a shared file
  157. repository).
  158. - You want to restrict access to uploaded files.
  159. To modify the file system path:
  160. a. Ensure that the new location for the path exists and is writable by the
  161. web server. For example, to create a new directory named uploads and grant
  162. write permissions, use the following commands on a Unix/Linux command
  163. line:
  164. mkdir uploads
  165. chmod a+w uploads
  166. b. Navigate to Administration > Configuration > Media > File system, and
  167. enter the desired path. Note that if you want to use private file storage,
  168. you need to first enter the path for private files and save the
  169. configuration, and then change the "Default download method" setting and
  170. save again.
  171. Changing the file system path after files have been uploaded may cause
  172. unexpected problems on an existing site. If you modify the file system path
  173. on an existing site, remember to copy all files from the original location
  174. to the new location.
  175. 7. Revoke documentation file permissions (optional).
  176. Some administrators suggest making the documentation files, especially
  177. CHANGELOG.txt, non-readable so that the exact version of Drupal you are
  178. running is slightly more difficult to determine. If you wish to implement
  179. this optional security measure, from a Unix/Linux command line you can use
  180. the following command:
  181. chmod a-r CHANGELOG.txt
  182. Note that the example only affects CHANGELOG.txt. To completely hide all
  183. documentation files from public view, repeat this command for each of the
  184. Drupal documentation files in the installation directory, substituting the
  185. name of each file for CHANGELOG.txt in the example.
  186. For more information on setting file permissions, see "Modifying Linux,
  187. Unix, and Mac file permissions" (http://drupal.org/node/202483) or
  188. "Modifying Windows file permissions" (http://drupal.org/node/202491) in the
  189. Drupal.org online documentation.
  190. 8. Set up independent "cron" maintenance jobs.
  191. Many Drupal modules have tasks that must be run periodically, including the
  192. Search module (building and updating the index used for keyword searching),
  193. the Aggregator module (retrieving feeds from other sites), and the System
  194. module (performing routine maintenance and pruning of database tables). These
  195. tasks are known as "cron maintenance tasks", named after the Unix/Linux
  196. "cron" utility.
  197. When you install Drupal, its built-in cron feature is enabled, which
  198. automatically runs the cron tasks periodically, triggered by people visiting
  199. pages of your site. You can configure the built-in cron feature by navigating
  200. to Administration > Configuration > System > Cron.
  201. It is also possible to run the cron tasks independent of site visits; this is
  202. recommended for most sites. To do this, you will need to set up an automated
  203. process to visit the page cron.php on your site, which executes the cron
  204. tasks.
  205. The URL of the cron.php page requires a "cron key" to protect against
  206. unauthorized access. Your site's cron key is automatically generated during
  207. installation and is specific to your site. The full URL of the page, with the
  208. cron key, is available in the "Cron maintenance tasks" section of the Status
  209. report page at Administration > Reports > Status report.
  210. As an example for how to set up this automated process, you can use the
  211. crontab utility on Unix/Linux systems. The following crontab line uses the
  212. wget command to visit the cron.php page, and runs each hour, on the hour:
  213. 0 * * * * wget -O - -q -t 1 http://example.com/cron.php?cron_key=YOURKEY
  214. Replace the text "http://example.com/cron.php?cron_key=YOURKEY" in the
  215. example with the full URL displayed under "Cron maintenance tasks" on the
  216. "Status report" page.
  217. More information about cron maintenance tasks is available at
  218. http://drupal.org/cron, and sample cron shell scripts can be found in the
  219. scripts/ directory. (Note that these scripts must be customized like the
  220. above example, to add your site-specific cron key and domain name.)
  221. BUILDING AND CUSTOMIZING YOUR SITE
  222. ----------------------------------
  223. A new installation of Drupal defaults to a very basic configuration. To extend
  224. your site, you use "modules" and "themes". A module is a plugin that adds
  225. functionality to Drupal, while a theme changes the look of your site. The core
  226. of Drupal provides several optional modules and themes, and you can download
  227. more at http://drupal.org/project/modules and http://drupal.org/project/themes
  228. Do not mix downloaded or custom modules and themes with Drupal's core modules
  229. and themes. Drupal's modules and themes are located in the top-level modules and
  230. themes directories, while the modules and themes you add to Drupal are normally
  231. placed in the sites/all/modules and sites/all/themes directories. If you run a
  232. multisite installation, you can also place modules and themes in the
  233. site-specific directories -- see the Multisite Configuration section, below.
  234. Never edit Drupal's core modules and themes; instead, use the hooks available in
  235. the Drupal API. To modify the behavior of Drupal, develop a module as described
  236. at http://drupal.org/developing/modules. To modify the look of Drupal, create a
  237. subtheme as described at http://drupal.org/node/225125, or a completely new
  238. theme as described at http://drupal.org/documentation/theme
  239. MULTISITE CONFIGURATION
  240. -----------------------
  241. A single Drupal installation can host several Drupal-powered sites, each with
  242. its own individual configuration.
  243. Additional site configurations are created in subdirectories within the 'sites'
  244. directory. Each subdirectory must have a 'settings.php' file, which specifies
  245. the configuration settings. The easiest way to create additional sites is to
  246. copy the 'default' directory and modify the 'settings.php' file as appropriate.
  247. The new directory name is constructed from the site's URL. The configuration for
  248. www.example.com could be in 'sites/example.com/settings.php' (note that 'www.'
  249. should be omitted if users can access your site at http://example.com/).
  250. Sites do not have to have a different domain. You can also use subdomains and
  251. subdirectories for Drupal sites. For example, example.com, sub.example.com, and
  252. sub.example.com/site3 can all be defined as independent Drupal sites. The setup
  253. for a configuration such as this would look like the following:
  254. sites/default/settings.php
  255. sites/example.com/settings.php
  256. sites/sub.example.com/settings.php
  257. sites/sub.example.com.site3/settings.php
  258. When searching for a site configuration (for example www.sub.example.com/site3),
  259. Drupal will search for configuration files in the following order, using the
  260. first configuration it finds:
  261. sites/www.sub.example.com.site3/settings.php
  262. sites/sub.example.com.site3/settings.php
  263. sites/example.com.site3/settings.php
  264. sites/www.sub.example.com/settings.php
  265. sites/sub.example.com/settings.php
  266. sites/example.com/settings.php
  267. sites/default/settings.php
  268. If you are installing on a non-standard port, the port number is treated as the
  269. deepest subdomain. For example: http://www.example.com:8080/ could be loaded
  270. from sites/8080.www.example.com/. The port number will be removed according to
  271. the pattern above if no port-specific configuration is found, just like a real
  272. subdomain.
  273. Each site configuration can have its own site-specific modules and themes in
  274. addition to those installed in the standard 'modules' and 'themes' directories.
  275. To use site-specific modules or themes, simply create a 'modules' or 'themes'
  276. directory within the site configuration directory. For example, if
  277. sub.example.com has a custom theme and a custom module that should not be
  278. accessible to other sites, the setup would look like this:
  279. sites/sub.example.com/
  280. settings.php
  281. themes/custom_theme
  282. modules/custom_module
  283. NOTE: for more information about multiple virtual hosts or the configuration
  284. settings, consult http://drupal.org/getting-started/6/install/multi-site
  285. For more information on configuring Drupal's file system path in a multisite
  286. configuration, see step 6 above.
  287. MORE INFORMATION
  288. ----------------
  289. - See the Drupal.org online documentation:
  290. http://drupal.org/documentation
  291. - For a list of security announcements, see the "Security advisories" page at
  292. http://drupal.org/security (available as an RSS feed). This page also
  293. describes how to subscribe to these announcements via e-mail.
  294. - For information about the Drupal security process, or to find out how to
  295. report a potential security issue to the Drupal security team, see the
  296. "Security team" page at http://drupal.org/security-team
  297. - For information about the wide range of available support options, visit
  298. http://drupal.org and click on Community and Support in the top or bottom
  299. navigation.