GOLF(2gg)

NAME
connect-apache-tcp-socket - Golf documentation (web-servers)

DESCRIPTION
This shows how to connect your application listening on TCP port <port number> (started with "-p" option in 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):

        ProxyPass "/<app path>/" fcgi://127.0.0.1:<port number>/

- 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