NginxProxyManager / NginxProxyManager/nginx-proxy-manager

Feature Request: Customizable Instance Name / Page Title

Open
#5,477 0 comments 2 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement
Dominant language
TypeScript
Stars
34.2k
Forks
3.9k
Avg merge
21h 12m
Merged PRs (30d)
20

Description

Problem

When managing multiple Nginx Proxy Manager instances simultaneously (e.g., production, staging, home lab), all instances share the same browser tab title "Nginx Proxy Manager". This makes it difficult to distinguish between tabs at a glance, increasing the risk of accidentally applying changes to the wrong instance.

Proposed Solution

Add an Instance Name setting in the Admin UI (under Settings), which would:

  • Replace or append to the browser <title> tag (e.g., "Nginx Proxy Manager - Production")
  • Optionally display the instance name in the navigation bar or header
  • Be configurable via both the UI and an environment variable (e.g., INSTANCE_NAME) for Docker-first workflows

Example environment variable usage:

environment:
  INSTANCE_NAME: "Production"

Example resulting title:

Nginx Proxy Manager - Production
Use Case

Users managing 2+ NPM instances open in separate browser tabs have no visual way to tell them apart without hovering over each tab or reading the URL. A simple customizable name solves this immediately.

Alternatives Considered
  • Manually patching frontend files inside the container — breaks on every update
  • Using a reverse proxy with sub_filter — adds unnecessary infrastructure complexity
  • Browser userscripts (Tampermonkey) — requires per-user setup, not a proper solution
Additional Context

This is a commonly requested quality-of-life improvement for homelab and production users running multiple NPM instances. Similar tools like Portainer and Grafana already support custom instance naming.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by locating the Admin UI Settings implementation and the existing environment-variable configuration path. Confirm how a setting can be stored and exposed to the frontend, then define the title and optional navigation display behavior. Done means an instance name can be configured through the UI or INSTANCE_NAME and distinguishes browser tabs reliably.

Written by the indexing model from the issue text.

Assessment

Tech stack
nginx, typescript
Domain
backend, frontend
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
55/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.