SuiteCloud CLI License Acceptance for Automation
Set SUITECLOUD_CLI_ACCEPT_LICENSE=true to suppress the SuiteCloud CLI license prompt during scripted npm installation.
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:
npm install -g @oracle/suitecloud-cliFor 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.
| Variable | Value | Documented effect |
|---|---|---|
SUITECLOUD_CLI_ACCEPT_LICENSE | true | Suppresses the license prompt during scripted installation and confirms acceptance of the Oracle Free Use Terms and Conditions |
SUITECLOUD_PROXY | Proxy URL | Configures a proxy server for SuiteCloud CLI; the value requires a protocol, hostname, and port |
The documented one-line installation command is:
SUITECLOUD_CLI_ACCEPT_LICENSE=true npm install -g @oracle/suitecloud-cliFor 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:
$env:SUITECLOUD_CLI_ACCEPT_LICENSE = 'true'npm install -g @oracle/suitecloud-cliThe 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:
suitecloud --versionUse 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:
- Confirm that the documented Java and Node.js prerequisites are available.
- Complete the organization’s review of the applicable license terms.
- Set
SUITECLOUD_CLI_ACCEPT_LICENSEtotrue. - Install
@oracle/suitecloud-cliglobally with npm. - Run
suitecloud --versionto check the current CLI version. - 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:
| Area | Documented requirement |
|---|---|
| Java | Oracle JDK version 17 or Oracle JDK version 21 |
| Node.js | Node.js version 24 LTS |
| Operating system | Windows, macOS, or Linux |
| NetSuite feature | SuiteCloud Development Framework enabled |
| NetSuite permissions | An administrator creates and assigns the SDF Developer role |
| Authentication | OAuth 2.0 enabled |
Oracle lists the following tested operating system and browser combinations:
| Operating system | Tested browsers |
|---|---|
| Windows 11 | Firefox and Chrome |
| Linux Fedora | Firefox and Chrome |
| macOS Sequoia | Firefox, 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
httporhttpsprotocol - A hostname
- A port number
Oracle’s example format is:
http://proxyurl:proxyportAfter 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=truefor scripted CLI installation and usesuitecloud --versionto check the current version. - Teams using a proxy: Need to create
SUITECLOUD_PROXYwith 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=truewhen 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_PROXYwith anhttporhttpsprotocol, 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?
How do PowerShell users set the license acceptance for a scripted SuiteCloud CLI install?
How do I configure a proxy for SuiteCloud CLI in automation?
What NetSuite prerequisites and permissions must be in place before installing or using SuiteCloud CLI?
Weekly Update History (1)
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 DocsWas this article helpful?
More in SuiteCloud Development Framework
- Enhancements to Custom Tool Scripts in NetSuite 2026.1
NetSuite 2026.1 improves custom tool scripts with execution logs, management page, and binary file support. TL;DR Opening
- SuiteCloud Extension for Visual Studio Code in NetSuite 2024.2
The article now includes updates from NetSuite 2026.2 for the SuiteCloud Extension for Visual Studio Code. SuiteCloud Extension for Visual Studio Code
- SuiteCloud CLI for Node.js: New Features in NetSuite 2026.1
Explore new features in SuiteCloud CLI for Node.js for streamlined development in NetSuite 2026.1.
- SuiteCloud CLI for Node.js Features in NetSuite 2026.1
The SuiteCloud CLI for Node.js offers interactive tools that enhance development in NetSuite, ensuring an efficient workflow.
Also from NetSuite 2026.2
- System Notes Enhancement for Reconciliation in NetSuite 2026.2
System notes enhancement tracks GL transaction events in NetSuite 2026.2, improving reconciliation auditing and review.
- Bank Matching and Reconciliation Enhancements in NetSuite 2026.2
Bank matching and reconciliation pages in NetSuite 2026.2 receive critical UI enhancements for improved transaction management.
- OAuth 2.0 Migration Required for NetSuite 2026.2 Authentication
NetSuite 2026.2 requires migration to OAuth 2.0 as NLAuth support ends in 2027.1. Switch to enhance integration security.
- Start Order Fulfillment from Sales Order Lists in NetSuite 2026.2
Start order fulfillment directly from sales order lists in NetSuite 2026.2, streamlining the process and reducing navigation steps.
Advertising
Reach SuiteCloud Development Framework Professionals
Put your product in front of NetSuite experts who work with SuiteCloud Development Framework every day.
Sponsor This Category