# Installation instructions

## Prepare database

as described in

    /usr/share/doc/civicrm-common/README.Debian

## Configure Wordpress instance

As per instructions in

  * /usr/share/doc/wordpress/README.Debian.gz

Wordpress configuration (in `/etc/wordpress/config-{SITENAME}.php`) is
expected to have the following:

~~~~
define('WP_CONTENT_DIR', '/var/lib/wordpress/{SITENAME}');
~~~~

To make CiviCRM available for the particular Wordpress instance, the
following symlink is necessary:

  ln -sv /usr/share/wordpress/wp-content/plugins/civicrm /var/lib/wordpress/{SITENAME}/plugins/civicrm

Of course "{SITENAME}" should be replaced with the actual site name (e.g.
"example.com") in all examples.

Installer URL:

    wp-admin/options-general.php?page=civicrm-install

CiviCRM installer saves settings into

    /var/lib/wordpress/{SITENAME}/uploads/civicrm/civicrm.settings.php

## See also

  * https://docs.civicrm.org/sysadmin/en/latest/install/wordpress/


Upgrade
-------

    https://docs.civicrm.org/sysadmin/en/latest/upgrade/wordpress/

Database schema upgrade:
    wp-admin/admin.php?page=CiviCRM&q=civicrm/upgrade&reset=1


Troubleshooting
---------------

Disable "Asset Caching" or (_Cleanup Caches_ and _Reset Paths_):

Debugging and Error Handling:
    wp-admin/admin.php?page=CiviCRM&q=civicrm/admin/setting/debug&reset=1

Cleanup Caches:
    wp-admin/admin.php?page=CiviCRM&q=civicrm/admin/setting/updateConfigBackend&reset=1