General Configuration SuiteCloud Security How-To

Configure HTTPS in Distro.json File for NetSuite

This guide details how to modify the distro.json file to enable HTTPS configuration in NetSuite. Modify the distro.json File

Published April 21, 2026·1 min read·View Oracle Docs

Modify the distro.json File

To access a secure domain on the local sever, you must ensure that the https object exists in the local object of taskConfig. After adding the https object, add an entry for the HTTPS port, certificate and key.

Your distro.json file should look similar to the following:

json

1"tasksConfig": {
2    "local": {
3        "http": {
4            "port": 7777
5        },
6        "lessSourcemap": false,
7        "jsRequire": true,
8        "https": {
9            "port": 7778,
10            "key": "KEYPEM",
11            "cert": "CERTPEM"
12        }
13    },
14    ...

Note:

You must set the key and cert properties as shown above. The local server uses these values to determine the environment variables used to local the certificate and key required to use HTTPS.

Frequently Asked Questions (4)

What is the purpose of adding an 'https' object to the 'distro.json' file?

The 'https' object is added to the 'distro.json' file to configure a secure domain on the local server by specifying the HTTPS port and the required certificate and key.

Do I need to include both 'key' and 'cert' properties in the 'https' configuration?

Yes, both 'key' and 'cert' properties must be included in the 'https' configuration. These are necessary for locating the environment variables that manage the HTTPS certificate and key on the local server.

Is it mandatory to use the specified port numbers for 'http' and 'https' in the 'distro.json' file?

No, the specified port numbers (7777 for 'http' and 7778 for 'https') are examples. You can customize port numbers based on your setup, but ensure they are correctly referenced elsewhere if changed.

Will modifying the 'distro.json' file impact existing server configurations?

Modifying the 'distro.json' file, especially adding the 'https' configuration, may impact how the local server handles secure connections, but it will primarily affect how the server operates locally rather than change external configurations.

Source: Modify the distro.json File — Oracle NetSuite Help Center. This article was generated from official Oracle documentation and enriched with additional context and best practices.

Was this article helpful?

Modify the distro.json File

Frequently Asked Questions (4)

More in General