Skip to content

Nginx Proxy Hosts

1. Host Overview

Proxy hosts represent domain configurations managed through the Nginx Proxy Manager API. Each host maps a domain to a backend service with SSL support.

Fields

  1. Domain Name - FQDN for this proxy host, e.g., app.example.com (required)
  2. Nginx Server - Reference to the Nginx connector (required, must be Confirmed)
  3. Nginx ID - Remote host ID assigned by Nginx Proxy Manager
  4. Certificate ID - SSL certificate ID on the remote server
  5. State - Host status: Draft, Running, Redirect, Stopped, or Deleted (tracked)
  6. Redirected To - URL to redirect traffic to (when state is Redirect)
  7. Created on Remote - Flag indicating the host exists on the remote server (readonly)

2. Host Lifecycle

Draft → Running → Stopped → Deleted
              ↓
          Redirect
State Description
Draft Not yet created on the remote Nginx server
Running Active and proxying traffic
Redirect Redirecting all traffic to a specified URL
Stopped Disabled on the remote server
Deleted Removed from the remote server

3. Actions

Action Description
Start Enables the host on the remote server (creates if new, enables if stopped)
Stop Disables the host without deleting it
Delete Removes the host from the remote Nginx server
Check Status Verifies the host exists on the remote server and compares configuration

SSL Certificates

When creating a host, the system automatically provisions a Let's Encrypt SSL certificate. If an existing certificate is found for the domain, it reuses the one with the latest expiry date.

Deletion Protection

Hosts that have been created on the remote server cannot be deleted from Odoo until they are first removed remotely via the Delete action.