Scroll to navigation

GOLF(2gg) Development GOLF(2gg)

NAME

connect-apache-unix-socket - Golf documentation (web-servers)

DESCRIPTION

This shows how to connect your application listening on a Unix socket (started with mgrg) to Apache web server.

- Step 1 : To setup Apache as a reverse proxy and connect your application to it, you need to enable FastCGI proxy support, which generally means "proxy" and "proxy_fcgi" modules - this is done only once:

• For Debian (like Ubuntu) and OpenSUSE systems you need to enable proxy and proxy_fcgi modules: 

sudo a2enmod proxy
sudo a2enmod proxy_fcgi

• For Fedora systems (or others like Archlinux) enable proxy and proxy_fcgi modules by adding (or uncommenting) LoadModule directives in the Apache configuration file - the default location of this file on Linux depends on the distribution. For Fedora (such as RedHat), Archlinux: 

sudo vi /etc/httpd/conf/httpd.conf

For OpenSUSE:

sudo vi /etc/apache2/httpd.conf

Add this to the end of the file:

LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_fcgi_module modules/mod_proxy_fcgi.so

- Step 2 : Edit the Apache configuration file:

• For Debian (such as Ubuntu): 

sudo vi /etc/apache2/apache2.conf

• for Fedora (such as RedHat), Archlinux: 

sudo vi /etc/httpd/conf/httpd.conf

• and for OpenSUSE: 

sudo vi /etc/apache2/httpd.conf

Add this to the end of file ("/<app path>" is the application path (see request) and "<app name>" is your application name):

ProxyPass "/<app path>/" unix:///var/lib/gg/<app name>/sock/sock|fcgi://localhost/<app path>

- Step 3 : Finally, restart Apache. On Debian systems (like Ubuntu) or OpenSUSE:

sudo systemctl restart apache2

On Fedora systems (like RedHat) and Arch Linux:

sudo systemctl restart httpd

Note: you must not have any other URL resource that starts with "/<app path>/" (such as for example "/<app path>/something") as the web server will attempt to pass them as a reverse proxy request, and they will likely not work. If you need to, you can change the application path to be different from "/<app path>", see request.

SEE ALSO


Web servers

connect-apache-tcp-socket connect-apache-unix-socket connect-haproxy-tcp-socket connect-nginx-tcp-socket connect-nginx-unix-socket See all documentation

$VERSION $DATE