NGINX Balancer Configuration

NGINX is the default load balancer automatically added when several application servers are selected in the environment topology. Its configuration is organized across the main NGINX file, feature-specific files, and TCP mapping settings.

In this article

Available Configuration Files
NGINX Main Configuration
CONF.D
TCPMAPS

Available Configuration Files

Folder	File	Path
nginx	`nginx.conf`	`/etc/nginx`
conf.d	Feature-specific configuration files	`/etc/nginx/conf.d`
tcpmaps	`mappings.xml`	`/etc/nginx/tcpmaps`

NGINX

The main configuration file for the NGINX balancer is nginx.conf, located in the /etc/nginx directory.

By default, nginx.conf includes automatically generated settings from the nginx-jelastic.conf file in the same directory.

NGINX nginx.conf file — The main nginx.conf file includes the automatically generated nginx-jelastic.conf settings by default.

Do not edit nginx-jelastic.conf directly. This file is generated automatically, and manual changes will eventually be overwritten by the platform.

If you need to customize these automatically generated settings:

Copy the contents of nginx-jelastic.conf.
Paste the copied content into nginx.conf, replacing the following include line:

include /etc/nginx/nginx-jelastic.conf;

Make the required adjustments directly in nginx.conf.

CONF.D

The /etc/nginx/conf.d directory contains additional feature-specific configuration files for the NGINX load balancer.

The include directive in the main nginx.conf file can be used to reference the contents of these feature-specific files.

NGINX conf.d settings — The conf.d directory stores additional feature-specific NGINX configuration files.

If required, existing files can be edited or custom configuration files can be uploaded to the conf.d directory.

TCPMAPS

The /etc/nginx/tcpmaps directory contains the mappings.xml file used to configure TCP load-balancing port redirects.

In mappings.xml, specify port pairs: one port for NGINX to listen on and another port to which the incoming connection should be redirected.

NGINX mappings.xml file — Use mappings.xml to define TCP listening and redirect port pairs.

For detailed TCP port-mapping behavior, refer to the TCP Load Balancing guide. NGINX caching is configured separately through the dedicated caching instructions.

Expected Result

The NGINX load balancer uses nginx.conf as its main configuration file, additional feature-specific settings from /etc/nginx/conf.d, and TCP redirect mappings from /etc/nginx/tcpmaps/mappings.xml. Platform-generated settings remain protected from accidental overwrite by keeping custom changes outside nginx-jelastic.conf.

Important Notes

NGINX is automatically added when multiple application servers are selected in the environment topology.
The main NGINX configuration file is /etc/nginx/nginx.conf.
nginx-jelastic.conf is generated automatically and should not be edited manually.
For permanent customization, copy the generated settings into nginx.conf and replace the include directive.
/etc/nginx/conf.d stores feature-specific configuration files and can also contain custom files.
/etc/nginx/tcpmaps/mappings.xml is used to define TCP balancing port redirects.

What’s Next?

Load Balancing
Caching in NGINX
Memcached Configuration
Custom Error Page Settings via NGINX Balancer

NGINX Balancer Configuration

NGINX is the default load balancer automatically added when several application servers are selected in the environment topology. Its configuration is organized across the main NGINX file, feature-specific files, and TCP mapping settings.

In this article

Available Configuration Files
NGINX Main Configuration
CONF.D
TCPMAPS

Available Configuration Files

Folder	File	Path
nginx	`nginx.conf`	`/etc/nginx`
conf.d	Feature-specific configuration files	`/etc/nginx/conf.d`
tcpmaps	`mappings.xml`	`/etc/nginx/tcpmaps`

NGINX

The main configuration file for the NGINX balancer is nginx.conf, located in the /etc/nginx directory.

By default, nginx.conf includes automatically generated settings from the nginx-jelastic.conf file in the same directory.

Do not edit nginx-jelastic.conf directly. This file is generated automatically, and manual changes will eventually be overwritten by the platform.

If you need to customize these automatically generated settings:

Copy the contents of nginx-jelastic.conf.
Paste the copied content into nginx.conf, replacing the following include line:

include /etc/nginx/nginx-jelastic.conf;

Make the required adjustments directly in nginx.conf.

CONF.D

The /etc/nginx/conf.d directory contains additional feature-specific configuration files for the NGINX load balancer.

The include directive in the main nginx.conf file can be used to reference the contents of these feature-specific files.

If required, existing files can be edited or custom configuration files can be uploaded to the conf.d directory.

TCPMAPS

The /etc/nginx/tcpmaps directory contains the mappings.xml file used to configure TCP load-balancing port redirects.

In mappings.xml, specify port pairs: one port for NGINX to listen on and another port to which the incoming connection should be redirected.

For detailed TCP port-mapping behavior, refer to the TCP Load Balancing guide. NGINX caching is configured separately through the dedicated caching instructions.

Expected Result

The NGINX load balancer uses nginx.conf as its main configuration file, additional feature-specific settings from /etc/nginx/conf.d, and TCP redirect mappings from /etc/nginx/tcpmaps/mappings.xml. Platform-generated settings remain protected from accidental overwrite by keeping custom changes outside nginx-jelastic.conf.

Important Notes

NGINX is automatically added when multiple application servers are selected in the environment topology.
The main NGINX configuration file is /etc/nginx/nginx.conf.
nginx-jelastic.conf is generated automatically and should not be edited manually.
For permanent customization, copy the generated settings into nginx.conf and replace the include directive.
/etc/nginx/conf.d stores feature-specific configuration files and can also contain custom files.
/etc/nginx/tcpmaps/mappings.xml is used to define TCP balancing port redirects.

What’s Next?

Load Balancing
Caching in NGINX
Memcached Configuration
Custom Error Page Settings via NGINX Balancer

NGINX Balancer Configuration

NGINX is the default load balancer automatically added when several application servers are selected in the environment topology. Its configuration is organized across the main NGINX file, feature-specific files, and TCP mapping settings.

In this article

Available Configuration Files
NGINX Main Configuration
CONF.D
TCPMAPS

Available Configuration Files

Folder	File	Path
nginx	`nginx.conf`	`/etc/nginx`
conf.d	Feature-specific configuration files	`/etc/nginx/conf.d`
tcpmaps	`mappings.xml`	`/etc/nginx/tcpmaps`

NGINX

The main configuration file for the NGINX balancer is nginx.conf, located in the /etc/nginx directory.

By default, nginx.conf includes automatically generated settings from the nginx-jelastic.conf file in the same directory.

Do not edit nginx-jelastic.conf directly. This file is generated automatically, and manual changes will eventually be overwritten by the platform.

If you need to customize these automatically generated settings:

Copy the contents of nginx-jelastic.conf.
Paste the copied content into nginx.conf, replacing the following include line:

include /etc/nginx/nginx-jelastic.conf;

Make the required adjustments directly in nginx.conf.

CONF.D

The /etc/nginx/conf.d directory contains additional feature-specific configuration files for the NGINX load balancer.

The include directive in the main nginx.conf file can be used to reference the contents of these feature-specific files.

If required, existing files can be edited or custom configuration files can be uploaded to the conf.d directory.

TCPMAPS

The /etc/nginx/tcpmaps directory contains the mappings.xml file used to configure TCP load-balancing port redirects.

In mappings.xml, specify port pairs: one port for NGINX to listen on and another port to which the incoming connection should be redirected.

For detailed TCP port-mapping behavior, refer to the TCP Load Balancing guide. NGINX caching is configured separately through the dedicated caching instructions.

Expected Result

The NGINX load balancer uses nginx.conf as its main configuration file, additional feature-specific settings from /etc/nginx/conf.d, and TCP redirect mappings from /etc/nginx/tcpmaps/mappings.xml. Platform-generated settings remain protected from accidental overwrite by keeping custom changes outside nginx-jelastic.conf.

Important Notes

NGINX is automatically added when multiple application servers are selected in the environment topology.
The main NGINX configuration file is /etc/nginx/nginx.conf.
nginx-jelastic.conf is generated automatically and should not be edited manually.
For permanent customization, copy the generated settings into nginx.conf and replace the include directive.
/etc/nginx/conf.d stores feature-specific configuration files and can also contain custom files.
/etc/nginx/tcpmaps/mappings.xml is used to define TCP balancing port redirects.