Documentation Index

Fetch the complete documentation index at: https://cli.ncloud-docs.com/llms.txt

Use this file to discover all available pages before exploring further.

Download CLI

Prev Next

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)
  • cli_linux: Installation file for the Linux environment
  • cli_windows: Installation file for the Windows environment
  • 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.
Caution
  • 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.
Note

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 $@