# Add a Staged Configuration

Type of document: Tutorial
Product: NGINX One Console

---


## Overview

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

It takes time to set up NGINX configuration files. 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 F5 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**.
1. Enter a name.
1. Select **Next**.

   You will see a new Staged Configuration with the default NGINX configuration file, `/etc/nginx/nginx.conf`, in edit mode.
1. Type or paste content for `/etc/nginx/nginx.conf`.
1. Select **Add File** to add the configuration, certificate, or other file(s) of your choice.
1. When you're done, select **Save**.

### Start from an existing Instance

To start from an existing Instance:

1. Select **Existing Source**.
1. Enter a name for your new Staged Configuration.
1. Select **Instance**.
1. In the Choose Instance menu that appears, select an existing Instance.
1. 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**.
1. Select **Config Sync Group**.
1. In the Choose Config Sync Group menu that appears, select an existing Config Sync Group.
1. Enter a name for your new Staged Configuration.
1. 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**.
1. Select **Staged Configuration**.
1. In the Choose Staged Configuration menu that appears, select an existing Staged Configuration.
1. Enter a name for your new Staged Configuration.
1. 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.