Configuration Files

GlobalForms reads its server settings from two files in the config folder of the install directory (C:\GlobalForms\config by default). This page explains which file to edit and how to apply changes.

The two configuration files

How the files combine

When GlobalForms starts, it reads default.json first and then applies local.json on top of it:

• A setting in local.json replaces the same setting in default.json.

• A setting you leave out of local.json keeps its default value.

• Within a section (an object in { }), you only need to include the settings you want to change. The rest of that section keeps its defaults.

• A list (an array in [ ]) is replaced as a whole. Include every entry you want, not just the new ones.

For example, this local.json changes only the HTTP port and turns on request logging. Every other setting keeps its default:

{
  "port": 3005,
  "settings": {
    "logging": {
      "request": {
        "enabled": true
      }
    }
  }
}

What setup writes to local.json

Change a setting

1. Make a backup copy of config\local.json.

2. Open config\local.json in a text editor, such as Notepad, running as administrator.

3. Add or change the setting. Keep the file valid JSON:

   • Put names and text values in double quotes: "domain": "https://forms.example.com".

   • Separate settings with commas, with no comma after the last setting in a section.

   • Write each backslash in a Windows path twice: "C:\\certs\\server.crt".

4. Save the file.

5. Restart the GlobalForms service. In PowerShell as administrator:

   PowerShell

   Restart-Service GlobalForms
   

   Or open Services, right-click GlobalForms Forms Server and select Restart.

Changes take effect only after the service restarts.

Common settings

Troubleshooting

Related pages

• Installing GlobalForms on Windows

• Configuring HTTPS

• Automatic Updates

• Database Configuration