Frequently Asked Questions

Common questions about NGINX as a Service for Azure.

Is NGINXaaS available in my subscription or in F5 subscription?

  • Your NGINXaaS deployment resource is visible to you under your subscription. The underlying compute resources of your deployment, which are managed by NGINX on your behalf, are not visible in your subscription.

Is NGINXaaS active-active? What is the architecture of NGINXaaS?

  • NGINXaaS is deployed as an active-active pattern for high availability. To learn more, see the user guide.

In which Azure regions is NGINXaaS currently supported?

  • We are constantly adding support for new regions. You can find the updated list of supported regions in the NGINXaaS documentation.

My servers are located in different geographies, can NGINXaaS load balance for these upstream servers?

  • Yes, NGINXaaS can load balance even if upstream servers are located in different geography as long as no networking limitations are mentioned in the Known Issues.

How do I analyze traffic statistics for NGINXaaS?

When should I scale my deployment?

  • Consider requesting additional NCUs if the number of consumed NCUs is over 70% of the number of provisioned NCUs. Consider reducing the number of requested NCUs when the number of consumed NCUs is under 60% of the number of provisioned NCUs. For more information on observing the consumed and provisioned NCUs in your deployment, see the Scaling documentation.

  • Alternatively, enable autoscaling to let the system automatically scale your deployment for you.

I am an NGINX Plus customer; how can I switch to NGINXaaS?

  • In NGINX Plus, customers SSH into the NGINX Plus system, store their certificates in some kind of storage and configure the network and subnet to connect to NGINX Plus.

  • For NGINXaaS, customers store their certificates in the Azure key vault and configure NGINXaaS in the same VNet or peer to the VNet in which NGINXaaS is deployed.

How does NGINXaaS react to a workload/traffic spike?

  • You can monitor the NCUs consumed by looking at the metrics tab of NGINXaaS. To learn about the NCUs consumed, choose NGINXaaS statistics and select “NCU consumed.” If the NCU consumed is close to the requested NCUs, we encourage you to scale your system and increase the NCU units. You can manually scale from your base NCUs (For example, 10) to up to 500 NCUs by selecting the NGINXaaS scaling tab.

  • Currently, we support scaling in 10 NCU intervals (10, 20, 30, and so on).

  • Alternatively, you can enable autoscaling, and NGINXaaS will automatically scale your deployment based on the consumption of NCUs.

  • See the Scaling Guidance documentation for more information.

What types and formats of certificates are supported in NGINXaaS?

  • NGINXaaS supports self-signed certificates, Domain Validated (DV) certificates, Organization Validated (OV) certificates, and Extended Validation (EV) certificates.

  • Currently, NGINXaaS supports PEM and PKCS12 format certificates.

  • See the SSL/TLS Certificates documentation to learn how to change certificates.

Does NGINXaaS support layer 4 load balancing?

  • Yes, NGINXaaS currently supports layer 4 TCP and HTTP layer 7 load balancing.

Does NGINXaaS support IP v6?

  • No, NGINXaaS does not support IPv6 yet.

What protocols do NGINXaaS support?

  • At this time, we support following two protocols
  • HTTPS
  • HTTP
  • HTTP/2
  • HTTP/3
  • TCP
  • QUIC
  • IMAP
  • POP3
  • SMTP

Does NGINXaaS support multiple public IPs, a mix of public and private IPs?

  • NGINXaaS supports one public or private IP per deployment. NGINXaaS doesn’t support a mix of public and private IPs at this time.

Can I change the IP address used for an NGINXaaS deployment to be public or private?

  • You cannot change the IP address associated with an NGINXaaS deployment from public to private, or from private to public.

How large should I make the subnet for NGINXaaS?

  • The minimum size subnet is /27; however, we recommend a subnet size of /24.

Can I deploy more than one NGINXaaS to a single subnet?

  • Yes, however, every deployment in the subnet will share the address space (range of IP addresses that resources can use within the VNet), so ensure the subnet is adequately sized to scale the deployments.

How long does it take to deploy NGINXaaS?

  • Typically you can deploy NGINXaaS in under 5 minutes.

Any downtime in the periodic updates?

  • There’s no downtime during updates to NGINXaaS.

Does changing the capacity of NGINXaaS result in any downtime?

  • No, there’s no downtime while an NGINXaaS deployment changes capacity.

How is my application safe at the time of disaster? Any method for disaster recovery?

  • In any Azure region with more than one availability zone, NGINXaaS provides cross-zone replication for disaster recovery. See Architecture for more details.

Can I configure the TLS policy to control TLS protocol versions?

  • Yes. You can overwrite the NGINX default protocol to configure the desired TLS/SSL policy. Read more about the procedure in the Module ngx_http_ssl_module documentation.

How many TLS/SSL certificates does NGINXaaS support?

  • NGINXaaS supports up to 100 TLS/SSL certificates.

Does NGINXaaS natively integrate with Azure Key Vault?

  • Yes, NGINXaaS natively integrates with Azure Key Vault, so you can bring your own certificates and manage them in a centralized location. You can learn more about adding certificates in Azure Key Vault in the SSL/TLS Certificates documentation.

Can I deploy any other resources in the NGINXaaS subnet?

  • Yes, the subnet can contain other resources and is not dedicated to the NGINXaaS for Azure resources; ensure the subnet size is adequate to scale the NGINXaaS deployment.

Are NSG (Network Security Group) supported on the NGINXaaS?

  • Yes, an NSG is required in the subnet where NGINXaaS will be deployed to ensure that the deployment is secured and inbound connections are allowed to the ports the NGINX service listens to.

Can I restrict access to NGINXaaS based on various criteria, such as IP addresses, domain names, and HTTP headers?

  • Yes, you can restrict access to NGINXaaS by defining restriction rules at the Network Security Group level or using NGINX’s access control list. To learn more, see the NGINX module ngx_http_access_module documentation.

What are the supported networking services of NGINXaaS?

  • NGINX currently supports VNet, and VPN gateway if they do not have limitations. Known limitations can be found in the Known Issues.

Does NGINXaaS support end-to-end encryption from client to the upstream server?

  • Yes, NGINXaaS supports end-to-end encryption from client to upstream server.

What types of logs does NGINXaaS provide?

  • NGINXaaS supports the following two types of logs.

  • Access Log: To troubleshoot server issues, analyze web traffic patterns and monitor server performance. For more details, please see the Module ngx_http_log_module documentation.

  • Error Log: To capture, troubleshoot and identify issues that may occur during the server’s operations, such as 400 bad requests, 401 unauthorized, 500 internal server errors, etc. For more details, please see the Core functionality documentation.

What is the retention policy for the above logs? How long are the logs stored? Where are they stored?

  • NGINXaaS logs are stored in customer’s storage. Customers can custom define the retention policy. Customers can configure the storage by following the steps outlined in the NGINXaaS Logging documentation.

Can I set up an alert with NGINXaaS?

  • You can set up an alert with NGINXaaS by following the steps outlined in the Configure Alerts documentation.

Is request tracing supported in NGINXaaS?

Can I select my desired instance type for NGINXaaS deployment?

  • No; NGINXaaS will deploy the right resources to ensure you get the right price-to-performance ratio.

Can I migrate from on-prem NGINX+ to NGINXaaS on Azure?

  • Yes, you can bring your own configurations or create a new configuration in the cloud. See the NGINXaaS Deployment documentation for more details.

Can I associate multiple certificates for the same domain?

  • Yes, the “ssl_certificate” directive can be specified multiple times to load certificates of different types. To learn more, see the Module ngx_http_ssl_module documentation.

What types of redirects does the NGINXaaS support?

What content types does NGINXaaS support for the message body for upstream/NGINXaaS error status code responses?

  • Customers can use any type of response message, including the following:
  • text/plain
  • text/css
  • text/html
  • application/javascript
  • application/json

Where do I find the NGINXaaS IP (Internet Protocol) address?

  • Once you successfully deploy NGINXaaS, you can double-click on NGINXaaS in the Azure portal; you can see both public and private IP addresses, as shown in the following screenshot:
IP location one
IP location two

Does my deployment IP change over time?

  • The NGINXaaS deployment IP doesn’t change over time.

Does NGINXaaS support autoscaling?

  • Yes; NGINXaaS supports autoscaling as well as manual scaling. Refer to the Scaling Guidance for more information.

How can I manually start/stop NGINXaaS?

  • Currently, we can’t manually start/stop NGINXaaS. You have the option to delete the deployment and re-deploy at a future date.

Can I change the virtual network or subnet for an existing NGINXaaS?

  • No, we do not currently support a change in the virtual network or subnet for an existing NGINXaaS deployment.

How do I configure HTTPS listeners for .com and .net sites?

  • NGINXaaS is a Layer 7 HTTP protocol. To configure .com and .net servers, refer to the server name in the server block within the HTTP context. To learn more, and see examples, follow the instructions in the NGINX Configuration documentation.

If I remove/delete an NGINXaaS deployment, what will happen to the eNICs that were associated with it?

  • When you remove or delete an NGINXaaS deployment, the associated eNICs will automatically be deleted.

What are the specific permissions that NGINXaaS for Azure needs?

  • The specific permissions required to deploy NGINXaaS are:

    • microsoft.network/publicIPAddresses/join/action

    • nginx.nginxplus/nginxDeployments/Write

    • microsoft.network/virtualNetworks/subnets/join/action

    • nginx.nginxplus/nginxDeployments/configurations/Write

    • nginx.nginxplus/nginxDeployments/certificates/Write

  • Additionally, if you are creating the Virtual Network or IP address resources that NGINXaaS for Azure will be using, then you probably also want those permissions as well.

  • Note that assigning the managed identity permissions normally requires an “Owner” role.

Can I reference my upstream servers by internal DNS hostname?

  • Yes. If your DNS nameservers are configured in the same VNet as your deployment, then you can use those DNS nameservers to resolve the hostname of the upstream servers referenced in your NGINX configuration.

Does changing the worker_connections in the NGINX config have any effect?

  • No. While changing the value of the directive in the config is allowed, the change is not applied to the underlying NGINX resource of your deployment.

What ports can my deployment listen on?

  • Due to port restrictions on Azure Load Balancer health probes, ports 19, 21, 25, 70, and 119 are not allowed. The NGINXaaS deployment can listen on all other ports. The maximum number of unique ports a configuration can listen on is 5. Configurations that specify over 5 unique ports will be rejected.

How often does my deployment get billed?

Why do the metrics show more connections and requests than I was expecting?

  • The NGINX agent periodically gathers connection and request statistics via an internal HTTP request. An Azure service health probe checks for status via a TCP connection for each listen port in the NGINX configuration, incrementing the connection count for each port. This contributes to minimal traffic and should not affect these metrics significantly.

Can I use an existing subnet to create my deployment?

  • You can use an existing subnet to create a deployment. Please make sure that the subnet is delegated to NGINX.NGINXPLUS/nginxDeployments before creating a deployment in it. To delegate a subnet to an Azure service, see Delegate a subnet to an Azure service.

Will my deployment detect a new version of my certificate and apply it?

Why are some of my deployment’s metrics intermittently missing in Azure monitor?

  • This may indicate that the deployment’s underlying compute resources are being exhausted. Monitor the system.cpu metric to see the deployment’s CPU utilization. If it’s nearing 100%, consider increasing the deployment’s NCU capacity. See the Scaling Guidance documentation for more information.