SuiteCloud CLI License Acceptance for Automation

Set SUITECLOUD_CLI_ACCEPT_LICENSE=true to suppress the SuiteCloud CLI license prompt during scripted npm installation.

·7 min read·112 views·NetSuite 2026.2·View Oracle Docs

Set SUITECLOUD_CLI_ACCEPT_LICENSE=true when installing SuiteCloud CLI for Node.js through a script, including a CI environment, to suppress its license prompt. Setting the variable confirms that the installer has read and accepted the Oracle Free Use Terms and Conditions. The documented installation uses npm’s global @oracle/suitecloud-cli package.

How does scripted license acceptance work?

SuiteCloud CLI for Node.js is available through npm as @oracle/suitecloud-cli. Oracle documents the following global installation command:

bash
npm install -g @oracle/suitecloud-cli

For installation through a script, such as in a CI environment, set SUITECLOUD_CLI_ACCEPT_LICENSE to true. This suppresses the license prompt. Setting the variable also confirms that the installing party has read and accepted the Oracle Free Use Terms and Conditions.

VariableValueDocumented effect
SUITECLOUD_CLI_ACCEPT_LICENSEtrueSuppresses the license prompt during scripted installation and confirms acceptance of the Oracle Free Use Terms and Conditions
SUITECLOUD_PROXYProxy URLConfigures a proxy server for SuiteCloud CLI; the value requires a protocol, hostname, and port

The documented one-line installation command is:

bash
SUITECLOUD_CLI_ACCEPT_LICENSE=true npm install -g @oracle/suitecloud-cli

For teams that manage shared installation scripts, keep the acceptance setting visible in the installation step. This is a governance practice rather than an Oracle requirement, but it lets the person reviewing automation see that the installation is accepting the stated terms.

What command should PowerShell users run?

Oracle provides a PowerShell example that assigns the environment variable before invoking npm:

powershell
$env:SUITECLOUD_CLI_ACCEPT_LICENSE = 'true'
npm install -g @oracle/suitecloud-cli

The important documented value is true. The source describes this setting specifically for scripted installation and CI environments; it does not describe alternative acceptance values or an approval workflow. Organizations should apply their own legal, procurement, or change-management process before placing license acceptance in shared automation.

For a broader installation walkthrough, including the standard npm workflow, see SuiteCloud CLI installation in NetSuite 2026.2.

How can teams check the installed CLI version?

Oracle states that you can check the current SuiteCloud CLI version with:

bash
suitecloud --version

Use this command as a separate post-installation step when a script needs to record the installed version. Retaining its output in job logs is an operational choice that can help teams compare installation results across build environments.

A practical scripted sequence is:

  1. Confirm that the documented Java and Node.js prerequisites are available.
  2. Complete the organization’s review of the applicable license terms.
  3. Set SUITECLOUD_CLI_ACCEPT_LICENSE to true.
  4. Install @oracle/suitecloud-cli globally with npm.
  5. Run suitecloud --version to check the current CLI version.
  6. Continue with the applicable account and project setup.

Which prerequisites apply to SuiteCloud CLI for Node.js?

The license-acceptance variable concerns the installation prompt. Oracle separately lists prerequisites for SuiteCloud CLI for Node.js:

AreaDocumented requirement
JavaOracle JDK version 17 or Oracle JDK version 21
Node.jsNode.js version 24 LTS
Operating systemWindows, macOS, or Linux
NetSuite featureSuiteCloud Development Framework enabled
NetSuite permissionsAn administrator creates and assigns the SDF Developer role
AuthenticationOAuth 2.0 enabled

Oracle lists the following tested operating system and browser combinations:

Operating systemTested browsers
Windows 11Firefox and Chrome
Linux FedoraFirefox and Chrome
macOS SequoiaFirefox, Safari, and Chrome

An account administrator enables SuiteCloud Development Framework at Setup > Company > Enable Features, on the SuiteCloud subtab, by selecting SuiteCloud Development Framework. The administrator must also enable the account features on which SDF depends and create and assign the SDF Developer role.

OAuth 2.0 is enabled at Setup > Company > Enable Features, on the SuiteCloud subtab, by selecting OAuth 2.0 in the Manage Authentication section.

Review the complete SuiteCloud CLI prerequisites for NetSuite development before preparing a development environment. Oracle identifies these items as prerequisites; setting the license variable does not replace them.

Oracle also directs users of npm 5.2 or later to npm’s official documentation about downloading and installing packages globally. That guidance is relevant because the documented SuiteCloud CLI command uses npm’s global -g option.

How is a proxy configured?

Oracle documents the SUITECLOUD_PROXY environment variable for proxy-server setup. Its value must include:

  • An http or https protocol
  • A hostname
  • A port number

Oracle’s example format is:

text
http://proxyurl:proxyport

After creating SUITECLOUD_PROXY, restart the console. The source does not specify proxy authentication, certificate handling, or exceptions for particular hosts, so those details should not be assumed from the documented example.

What does accepting the license cover?

Installing SuiteCloud CLI for Node.js accepts installation of the SuiteCloud SDK dependency under the Oracle Free Use Terms and Conditions. The source distinguishes the Programs covered by those terms from technology identified in program documentation, readmes, or notice files as Separately Licensed Technology.

The terms state that Oracle grants a nonexclusive, nontransferable, limited license to internally use unmodified Programs for developing, testing, prototyping, and demonstrating applications, and for an organization’s own internal business operations. They also permit redistribution of unmodified Programs and Program Documentation under the license, provided end users are not charged additional fees for use of the Programs.

Other stated conditions include the following:

  • Include a copy of the license with any distribution of the Programs.
  • Do not remove Oracle’s or a licensor’s proprietary-rights markings or notices.
  • Comply with applicable U.S. export control and economic sanctions laws and regulations governing use of the Programs, including technical data.
  • Do not cause or permit reverse engineering, disassembly, or decompilation, except as allowed by law.
  • Treat included source code as reference-only unless Separate Terms permit modification.

The terms permit copies reasonably necessary to exercise the granted rights and for backup purposes. They permit third-party training in use of the Programs and associated Separately Licensed Technology only where Oracle expressly authorizes it on the Program download page or in Program Documentation.

Oracle or its licensors retain ownership and intellectual-property rights in the Programs. The terms further state that installation or auto-update processes may transmit a limited amount of process-related data to Oracle or its service provider to help Oracle understand and optimize those processes; Oracle states that this data is not associated with personally identifiable information.

The Programs are provided “as is” without warranties, including implied warranties of merchantability, fitness for a particular purpose, and noninfringement. The terms also limit Oracle’s liability for damages arising from use or inability to use the Program, subject to applicable law.

What can SuiteCloud CLI for Node.js do?

SuiteCloud CLI for Node.js works with a developer’s IDE to develop SuiteCloud projects and is part of the SuiteCloud Development Framework Software Development Kit. Oracle lists these capabilities:

  • Create a SuiteCloud project.
  • Link an account to SuiteCloud projects.
  • Import SDF custom objects from an account.
  • Import SuiteScript files from an account’s File Cabinet.
  • Deploy a SuiteCloud project to an account.
  • Add unit testing with the Jest testing framework.

Oracle’s Node.js guidance covers SuiteCloud project development. It does not provide the installation procedure for developing Commerce website extensions, for which Oracle directs users to separate Node.js instructions.

Teams incorporating the CLI into assisted development processes can also review SuiteCloud Developer Assistant workflow practices after the base CLI, account features, permissions, and authentication are ready.

Who This Affects

  • SuiteCloud developers: Need the CLI installation prerequisites, an assigned SDF Developer role, and OAuth 2.0 enabled in the account.
  • NetSuite administrators: Enable SDF and its dependent account features, enable OAuth 2.0, and create and assign the SDF Developer role.
  • CI and platform teams: Can use SUITECLOUD_CLI_ACCEPT_LICENSE=true for scripted CLI installation and use suitecloud --version to check the current version.
  • Teams using a proxy: Need to create SUITECLOUD_PROXY with a protocol, hostname, and port, then restart the console.
  • License reviewers: Should recognize that setting the acceptance variable confirms that the installer has read and accepted the Oracle Free Use Terms and Conditions.

Key Takeaways

  • Set SUITECLOUD_CLI_ACCEPT_LICENSE=true when installing SuiteCloud CLI for Node.js through a script to suppress the license prompt.
  • Setting the variable confirms acceptance of the Oracle Free Use Terms and Conditions.
  • Install the npm package globally with npm install -g @oracle/suitecloud-cli.
  • Check the current CLI version with suitecloud --version.
  • The documented Java, Node.js, operating-system, SDF, SDF Developer role, and OAuth 2.0 prerequisites still apply.
  • Configure SUITECLOUD_PROXY with an http or https protocol, hostname, and port, then restart the console.

Frequently Asked Questions (4)

How do I suppress the SuiteCloud CLI license prompt during scripted npm installs or CI builds?
Set SUITECLOUD_CLI_ACCEPT_LICENSE=true before running the global npm install for the CLI. For example: SUITECLOUD_CLI_ACCEPT_LICENSE=true npm install -g @oracle/suitecloud-cli; setting the variable also confirms acceptance of the Oracle Free Use Terms and Conditions.
How do PowerShell users set the license acceptance for a scripted SuiteCloud CLI install?
In PowerShell assign the environment variable then run npm, for example: $env:SUITECLOUD_CLI_ACCEPT_LICENSE = 'true' followed by npm install -g @oracle/suitecloud-cli. The documented value is 'true' and the guidance is specifically for scripted installations and CI environments; organizations should apply their own legal or change-management approval before placing acceptance in shared automation.
How do I configure a proxy for SuiteCloud CLI in automation?
Create the SUITECLOUD_PROXY environment variable with an http or https protocol, hostname, and port (example format: http://proxyurl:proxyport), then restart the console. The documentation does not provide details about proxy authentication, certificate handling, or host exceptions, so those details should not be assumed from the example.
What NetSuite prerequisites and permissions must be in place before installing or using SuiteCloud CLI?
Documented prerequisites include Oracle JDK 17 or 21, Node.js 24 LTS, a supported OS (Windows, macOS, or Linux), SuiteCloud Development Framework enabled in the account, an SDF Developer role created and assigned by an administrator, and OAuth 2.0 enabled. Setting SUITECLOUD_CLI_ACCEPT_LICENSE=true only suppresses the installer prompt and does not replace these prerequisites.

Weekly Update History (1)

SuiteCloud SDKadded

Added instructions for suppressing the SuiteCloud CLI for Node.js license prompt in scripted and CI installations in Installing SuiteCloud CLI for Node.js.

View Oracle Docs
Source: Installing SuiteCloud CLI for Node.js Oracle NetSuite Help Center. This article was generated from official Oracle documentation and enriched with additional context and best practices.

Was this article helpful?

More in SuiteCloud Development Framework

View all SuiteCloud Development Framework articles →

Also from NetSuite 2026.2

View all NetSuite 2026.2 changes →