Available in Classic and VPC
This section describes how to install the Ncloud CLI.
Installation
Download CLI
Download the CLI file for your operating system (Windows, Linux). CLIs must always be maintained with the latest version for proper opration.
| Version | Date of publication | File |
|---|---|---|
| 1.1.29 | 2026-04-23 | CLI_1.1.29_20260423.zip (281 MB)
|
- Changes: ncloud-api-cli-[version]-SNAPSHOT-jar-with-dependencies file
File configuration
The downloaded CLI files are available for both Windows and Linux environments. The structure of both files is the same, but the execution method differs depending on the environment.
- jre8: Ncloud CLI is developed using Java, so it requires the Java Runtime Environment (JRE). Since the CLI folder includes JRE 8, note that if JRE or JDK is already installed on the system where you are running the CLI, you may not need to install it again. (Runs on Java 1.8 or later)
- lib: It is a folder that contains the .jar file related to CLI.
- ncloud: It is a script file to execute the CLI jar file. The file extension differs depending whether it is a Windows or Linux environment.
- JDK 1.7 was used for versions up to CLI 1.0.17, but JDK 1.8 is being used for CLI 1.0.18 or later. Thus, problems may occur when running on JDK 1.9 or later.
- When using the internal JDK, scripts also need to be changed.
Confirm installation
Navigate to the folder where you downloaded the files, then run the ncloud command to verify that the CLI has been installed correctly.
- Windows
cd C:\Users\{username}\Downloads\CLI_1.1.28_20260122\cli_windows
ncloud
- Linux
cd ~/Downloads/CLI_1.1.28_20260122/cli_linux
./ncloud
If the following message appears, the CLI has been installed successfully.
ncloud <command> [subcommand] help
ncloud: error: The command does not exist. For help, input 'help' command.
The message above is an informational message displayed because no command was specified; it is not a CLI installation error.
Connect existing JRE or JDK
If you are using a JRE or JDK already installed in your local environment rather than the included JRE file, change ./jre8/bin/java to java in the ncloud script file. A JRE or JDK must be installed in your local environment.
- Before Modification
#!/bin/bash HOME='./lib' /jre8/bin/java -jar ${HOME}/ncloud-api-cli-1.0.2-SNAPSHOT-jar-with-dependencies.jar $@ - After Modification
#!/bin/bash HOME='./lib' java -jar ${HOME}/ncloud-api-cli-1.0.2-SNAPSHOT-jar-with-dependencies.jar $@