Add a Staged Configuration

Overview

This guide explains how to add a Staged Configuration to your NGINX One Console.

It takes time to set up NGINX configuration files can take time. Staged Configurations can help. They work like a draft that uses the features of NGINX One Console. The Staged Configuration does not have to be valid. You can save your work before you push a configuration to an instance of NGINX.

With Staged Configurations, you can use these features of NGINX One Console:

  • Automatic syntax checking
  • Contextual documentation
  • Dynamic analysis of your work in progress
  • Suggestions from our AI assistant

Once you’ve finished your work and have pushed the changes to an Instance or a Config Sync Group, you can next delete that Staged Configuration.

Before you start

Before you add a Staged Configuration to NGINX One Console, ensure:

  • You have an NGINX One Console account with staged configuration permissions.

Add a Staged Configuration

You can add a Staged Configuration from:

  • Empty files
  • An existing Instance
  • An existing Config Sync Group
  • An existing Staged Configuration

To start the process from NGINX One Console, select Manage > Staged Configruations. Select Add Staged Configuration.

The following sections start from the Add Staged Configuration window that appears.

Start from an empty file

To start a new Staged Configuration:

  1. Select New Configuration.

  2. Enter a name.

  3. Select Next.

    You will see a new Staged Configuration with the default NGINX configuration file, /etc/nginx/nginx.conf, in edit mode.

  4. Type or paste content for /etc/nginx/nginx.conf.

  5. Select Add File to add the configuration, certificate, or other file(s) of your choice.

  6. When you’re done, select Save.

Start from an existing Instance

To start from an existing Instance:

  1. Select Existing Source.
  2. Enter a name for your new Staged Configuration.
  3. Select Instance.
  4. In the Choose Instance menu that appears, select an existing Instance.
  5. Select Next.

NGINX One Console imports the configuration from the existing Instance. You can now edit the configuration. When you’re ready to stop and save your work, select Save.

Start from an existing Config Sync Group

To start from an existing Config Sync Group:

  1. Select Existing Source.
  2. Select Config Sync Group.
  3. In the Choose Config Sync Group menu that appears, select an existing Config Sync Group.
  4. Enter a name for your new Staged Configuration.
  5. Select Next.

NGINX One Console imports the configuration from the existing Config Sync Group. You can now edit the configuration. When you’re ready to stop and save your work, select Save.

Start from an existing Staged Config

To start from an existing Staged Config:

  1. Select Existing Source.
  2. Select Staged Configuration.
  3. In the Choose Staged Configuratiog menu that appears, select an existing Staged Configuration.
  4. Enter a name for your new Staged Configuration.
  5. Select Next.

NGINX One Console imports the configuration from the existing Staged Configuration. You can now edit the configuration. When you’re ready to stop and save your work, select Save.

Last modified March 21, 2025