[Story]: Add documentation for how a customer can switch their instance to the new target namespace.
Open
@AliMahmoudDev is already working on this.
Since Jun 3, 2026.
enhancement
good first issue
P4 - Low (TTR: 90 days)
product/nginx-one
- Dominant language
- HTML
- Stars
- 94
- Forks
- 174
- Avg merge
- 1d 10h
- Merged PRs (30d)
- 66
Description
Overview
Clearly document steps for the customer on steps to take when switching their instance to the new target namespace.
Which product or products does this request relate to?
NGINX One Console
Description
The switch to the new target namespace requires customer to complete the following steps to deregister their existing instance and register it as per the target namespace:
- Switch to target namespace
- Create a new data-plane key
- Update configuration of the already installed agent, to point to the new data-plane key.
- Restart agent
- Verify the instance shows up in the target namespace
This task is to document this process for the customer.
Acceptance criteria
- Documentation added to showcase to the customer how to achieve the instance switch to a new target namespace.
- The link to the documentation is added to the
content/nginx-one/glossary.mdpage.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.