Skip to content

Server

The server section of the Nginx UI configuration deals with various settings that control the behavior and operation of the Nginx UI server. In this section, we will discuss the available options, their default values, and their purpose.

Host

  • Type: string
  • Version: >= v2.0.0-beta.37
  • Default:0.0.0.0

The hostname on which the Nginx UI server listens for incoming HTTP requests. Changing the default hostname can be useful for improving the security of Nginx UI.

Port

  • Type: uint
  • Version: >= v2.0.0-beta.37
  • Default: 9000

This option is used to configure the port on which the Nginx UI server listens for incoming HTTP requests. Changing the default port can be useful for avoiding port conflicts or enhancing security.

RunMode

  • Type: string
  • Supported value: releasedebug
  • Default: debug

This option is used to configure the running mode of the Nginx UI server, which mainly affects the level of log printing.

The log level of Nginx UI is divided into 6 levels: Debug, Info, Warn, Error, Panic and Fatal. These log levels increase in severity.

When using the debug mode, Nginx UI will print SQL and its execution time and caller on the console, and the log of Debug level or higher will also be printed.

When using the release mode, Nginx UI will not print the execution time and caller of SQL on the console, and only the log of Info level or higher will be printed.

HttpHost

  • Type: string
  • Default:0.0.0.0

WARNING

Deprecated in v2.0.0-beta.37, please use Host instead.

The hostname on which the Nginx UI server listens for incoming HTTP requests. Changing the default hostname can be useful for improving the security of Nginx UI.

HttpPort

  • Type: int
  • Default: 9000

WARNING

Deprecated in v2.0.0-beta.37, please use Port instead.

This option is used to configure the port on which the Nginx UI server listens for incoming HTTP requests. Changing the default port can be useful for avoiding port conflicts or enhancing security.

JwtSecret

  • Type: string

WARNING

Deprecated in v2.0.0-beta.37, please use App.JwtSecret instead.

This option is used to configure the key used by the Nginx UI server to generate JWT.

JWT is a standard for verifying user identity. It can generate a token after the user logs in, and then use the token to verify the user's identity in subsequent requests.

If you use the one-click installation script to deploy Nginx UI, the script will generate a UUID value and set it as the value of this option.

NodeSecret

  • Type: string
  • Version: >= v2.0.0-beta.24, <= 2.0.0-beta.36

WARNING

Deprecated in v2.0.0-beta.37, please use Node.Secret instead.

This secret is used to authenticate the communication between the Nginx UI servers. Also, you can use this secret to access the Nginx UI API without a password.

HTTPChallengePort

  • Type: int
  • Default: 9180

WARNING

Deprecated in v2.0.0-beta.37, please use Cert.HTTPChallengePort instead.

This option is used to set the port for backend listening in the HTTP01 challenge mode when obtaining Let's Encrypt certificates. The HTTP01 challenge is a domain validation method used by Let's Encrypt to verify that you control the domain for which you're requesting a certificate.

Email

  • Type: string

WARNING

Deprecated in v2.0.0-beta.37, please use Cert.Email instead.

When obtaining a Let's Encrypt certificate, this option is used to set your email address. Let's Encrypt will use your email address to notify you of the expiration date of your certificate.

Database

  • Type: string
  • Default: database

WARNING

Deprecated in v2.0.0-beta.37, please use Database.Name instead.

This option is used to set the name of the sqlite database used by Nginx UI to store its data.

StartCmd

  • Type: string
  • Default: login

WARNING

Deprecated in v2.0.0-beta.37, please use Terminal.StartCmd instead.

This option is used to set the start command of the web terminal.

WARNING

For security reason, we use login as the start command, so you have to log in via the default authentication method of the Linux. If you don't want to enter your username and password for verification every time you access the web terminal, please set it to bash or zsh (if installed).

PageSize

  • Type: int
  • Default: 10

WARNING

Deprecated in v2.0.0-beta.37, please use App.PageSize instead.

This option is used to set the page size of list pagination in the Nginx UI. Adjusting the page size can help in managing large amounts of data more effectively, but a too large number can increase the load on the server.

CADir

  • Type: string

WARNING

Deprecated in v2.0.0-beta.37, please use Cert.CADir instead.

When applying for a Let's Encrypt certificate, we use the default CA address of Let's Encrypt. If you need to debug or obtain certificates from other providers, you can set CADir to their address.

TIP

Please note that the address provided by CADir needs to comply with the RFC 8555 standard.

GithubProxy

  • Type: string
  • Suggestion: https://mirror.ghproxy.com/

WARNING

Deprecated in v2.0.0-beta.37, please use Http.GithubProxy instead.

For users who may experience difficulties downloading resources from GitHub (such as in mainland China), this option allows them to set a proxy for github.com to improve accessibility.

CertRenewalInterval

  • Version:>= v2.0.0-beta.22, <= 2.0.0-beta.36
  • Type: int
  • Default value: 7

WARNING

Deprecated in v2.0.0-beta.37, please use Cert.CertRenewalInterval instead.

This option is used to set the automatic renewal interval of the Let's Encrypt certificate. By default, Nginx UI will automatically renew the certificate every 7 days.

RecursiveNameservers

  • Version:>= v2.0.0-beta.22, <= 2.0.0-beta.36
  • Type: []string
  • Example: 8.8.8.8:53,1.1.1.1:53

WARNING

Deprecated in v2.0.0-beta.37, please use Cert.RecursiveNameservers instead.

This option is used to set the recursive nameservers used by Nginx UI in the DNS challenge step of applying for a certificate. If this option is not configured, Nginx UI will use the nameservers settings of the operating system.

SkipInstallation

  • Version:>= v2.0.0-beta.23, <= 2.0.0-beta.36
  • Type: bool
  • Default value: false

WARNING

Deprecated in v2.0.0-beta.37, please use Node.SkipInstallation instead.

You can skip the installation of the Nginx UI server by setting this option to true. This is useful when you want to deploy Nginx UI to multiple servers with the same configuration file or environment variables.

By default, if you enabled the skip installation mode without setting the JWTSecret and NodeSecret options in the server section, Nginx UI will generate a random UUID value for these two options.

Plus, if you don't set the Email option also in the server section, Nginx UI will not create a system initial acme user, this means you can't apply for an SSL certificate in this server.

Name

  • Version:>= v2.0.0-beta.23, <= 2.0.0-beta.36
  • Type: string

WARNING

Deprecated in v2.0.0-beta.37, please use Http.InsecureSkipVerify instead.

Use this option to customize the name of local server to be displayed in the environment indicator.

InsecureSkipVerify

  • Version:>= v2.0.0-beta.30, <= 2.0.0-beta.36
  • Type: bool

WARNING

Deprecated in v2.0.0-beta.37, please use Http.InsecureSkipVerify instead.

This option is used to skip the verification of the certificate of servers when Nginx UI sends requests to them.

Released under the AGPL-3.0 License. (996ec807)