Custom vHost

The vHost tab shows the website’s full Nginx configuration and lets you rewrite it when you need rewrite rules, headers or special locations.

Default and custom

The badge at the top of the tab shows the state:

• Default: configuration generated by the panel. Changes in the Overview and SSL tabs update it automatically.
• Custom: after you save content that differs from what the panel generates.

Editing the configuration

1. Edit the text in the Configuration field.
2. Click save.

The panel validates with nginx -t before applying. If Nginx reports an error, the running configuration is kept and the detailed error appears on the page. The maximum size is shown under the field.

Caution

If the website has SSL, keep the location /.well-known/acme-challenge/ block so the Let’s Encrypt certificate can renew.

While a custom configuration is active

These changes are not applied automatically to a hand-written configuration, and the panel refuses them until you go back to the default:

• changing the domain,
• enabling or removing SSL,
• changing the HTTPS redirect.

Let’s Encrypt renewal keeps working.

Resetting to default

While the vHost is custom, a Reset to default configuration section appears at the bottom of the tab. Its button discards the hand-written configuration and lets the panel regenerate it. Your custom text is lost, so copy it elsewhere first if you still need it.