Skip to main content

​
Introduction

Nginx templates allow you to customize the Nginx site configuration that Laravel Forge uses when creating your new site.
Nginx templates that are not valid will prevent Nginx from properly working and your existing sites may stop responding. You should proceed with caution when creating and deploying custom Nginx templates.

​
Managing templates

​
Create template

You may create your own Nginx templates from within a server’s management dashboard. When creating a new template, you need to provide a template name and the template’s content. Laravel Forge will provide a default template that you may alter as required.
Although the default template does not show support for TLSv1.3, Laravel Forge will automatically update a site to support it if the server is able to do so.

​
Edit templates

You may edit the name and content of your Nginx template at any time. Changes to a template will not affect existing sites that use the template.

​
Delete templates

Deleting a template will not remove any sites which were configured to use it.

​
Template variables

Laravel Forge provides several variables that can be used within your templates to dynamically alter their content for new sites: When using these variables, you should ensure that they exactly match the syntax shown above.

​
Team permissions

The ability to manage Nginx Templates is determined by the site:manage-nginx permission. This permission is also used to restrict the ability to edit an existing site’s Nginx configuration file.