Installing API behind mod_wsgi

mod_wsgi requires a script on disk and cannot reference the watcher.wsgi.api:application module path directly. The steps below use the watcher-api-wsgi script generated at install time. See Using WSGI with Watcher for the other deployment options.

1. Install the Apache Service:

   Fedora/RHEL/CentOS:
     sudo dnf install httpd
   
   Debian/Ubuntu:
     apt-get install apache2
   

2. Copy etc/apache2/watcher.conf under the apache sites:

   Fedora/RHEL/CentOS:
     sudo cp etc/apache2/watcher /etc/httpd/conf.d/watcher.conf
   
   Debian/Ubuntu:
     sudo cp etc/apache2/watcher /etc/apache2/sites-available/watcher.conf
   

3. Edit <apache-configuration-dir>/watcher.conf according to installation and environment.

   • Modify the WSGIDaemonProcess directive to set the user and group values to appropriate user on your server.

   • Modify the WSGIScriptAlias directive to point to the watcher-api-wsgi script, as installed on your system.

   • Modify the Directory directive to set the path to the Watcher API code.

   • Modify the ErrorLog and CustomLog to redirect the logs to the right directory.

4. Enable the apache watcher site and reload:

   Fedora/RHEL/CentOS:
     sudo systemctl reload httpd
   
   Debian/Ubuntu:
     sudo a2ensite watcher
     sudo service apache2 reload