Skip to content

Nginx Servers

1. Connector Overview

Nginx connectors represent a connection to an Nginx Proxy Manager instance. Each connector authenticates via JWT token and manages proxy hosts on the remote server.

Fields

  1. Name - Server display name (required, tracked)
  2. URL - API endpoint URL for the Nginx Proxy Manager (required, tracked)
  3. IP - Server IP address (required, tracked)
  4. Username - Authentication username (required, tracked)
  5. Password - Authentication password (required)
  6. Token - JWT bearer token, auto-generated on confirmation (readonly)
  7. Token Expiry Period - Token lifetime (readonly, default: 1y)
  8. Token Expiry - Token expiration timestamp (readonly)
  9. Country - Server location country
  10. State - Server location state/province
  11. State - Connector status: Draft, Confirmed, or Cancelled (tracked)
  12. Active - Archive toggle (default: True)
  13. Hosts Count - Number of proxy hosts managed by this connector (computed)

2. Connector Lifecycle

Draft → Confirmed → Cancelled
State Description
Draft Initial setup, credentials editable
Confirmed JWT token generated from API, ready for host management
Cancelled Deactivated

3. Actions

Action Description
Confirm Server Authenticates with the Nginx API and generates a JWT token
Reset to Draft Clears the token and returns to editable state
Cancel Deactivates the connector
Open Nginx Panel Opens the Nginx Proxy Manager UI in a new browser tab

Token Management

The JWT token is automatically validated before each host operation. If expired, it is regenerated transparently using the stored credentials.

Deletion Protection

A connector cannot be deleted if it has linked proxy hosts. Remove all hosts first.