Skip to main content

🔄 NGINX Safe Reload (Add-on)

The NGINX Safe Reload add-on allows you to apply changes to NGINX safely, without restarting the service and without dropping active connections. It performs a syntax check of the configuration before reloading, ensuring that the changes do not cause failures.

✅ Prerequisites​

  • Environment with NGINX Load Balancer on Saveincloud

  • Access to the platform panel

🚀 Add-on Installation​

  1. Access your environment on Saveincloud.

  2. In the NGINX Load Balancer container, click the Add-ons button.

  3. Locate the NGINX Safe Reload add-on. imagem

  4. Click Install.

⚙️ How to use​

After installation, two buttons will be available:

🔍 Check Configs​

imagem

  • Executes the command nginx -t to validate the current configuration syntax.

  • If everything is correct, the message will be displayed:


nginx: the configuration file /etc/nginx/nginx.conf syntax is ok

nginx: configuration file /etc/nginx/nginx.conf test is successful

🔄 Reload​

imagem

  • Applies the changes to NGINX safely (equivalent to nginx -s reload).

  • If successful, the message will appear:


The NGINX service has been safely reloaded!

⚠️ If there are syntax errors, the reload will not be applied, ensuring environment stability.

✅ Advantages​

  • No active connections are dropped

  • Safe and validated reload

  • Ideal for production environments

🧪 Usage example​

  1. Edit the NGINX configuration (/etc/nginx/nginx.conf or sites-enabled/).

  2. Click Check Configs to validate. `imagem

  3. If there are no errors, click Reload to apply the change. ![imagem](https://s3.docs.saveincloud.com/images/imagem_1751140868282.png) imagem

✅ Conclusion​

With the NGINX Safe Reload add-on, you can safely apply changes to NGINX directly through the Saveincloud interface, avoiding interruptions in your environment.