ossutil supports the following operating systems: Windows, Linux, and macOS. You can download and install the ossutil version that best suits your requirements.

Version and runtime environment

  • Current version: 1.7.7
  • Source code: ossutil
  • Runtime environment
    • Windows/Linux/macOS
    • Supported architectures: x86 (32-bit and 64-bit) and ARM (32-bit and 64-bit)

Download URLs

Download the package based on your operating system and run the corresponding binary file to install and configure ossutil. In this topic, ossutil is installed on 64-bit operating systems.

Install ossutil on Linux

  1. Run the following command to download the ossutil installation package:
    wget http://gosspublic.alicdn.com/ossutil/1.7.7/ossutil64                           
    Notice When you use the copied URL in the wget command to download ossutil, delete the ?spm=xxxx part from the URL.
  2. Run the following command to modify the execution permissions of the file:
    chmod 755 ossutil64
  3. Generate a configuration file in interactive mode.
    1. Run the following command:
      ./ossutil64 config
    2. Configure the path of the configuration file as prompted.

      We recommend that you use the default path for the configuration file by pressing the Enter key.

      Enter the name of the configuration file. The file name can contain a path. The default path is /home/user/.ossutilconfig. If you press the Enter key without specifying a different path, the file is generated in the default path. 
      If you want to generate the file in another path, set the --config-file option to the path when you run this command. 
      By default, ossutil uses /home/user/.ossutilconfig as the configuration file. If you set the path of the configuration file, you must add the -c option to specify the configuration file each time you run this command. For example, if you save the configuration file as /home/config, add the -c option in the following format when you run the ls command:
      ./ossutil64 ls oss://examplebucket -c /home/config
    3. Set the language of ossutil as prompted.
      Enter the language: CH or EN. The default language is CH. The configuration of this parameter takes effect after the config command is run. 
    4. Configure the parameters, including endpoint, accessKeyID, accessKeySecret, and stsToken as prompted.

      You can refer to the following descriptions when you configure the parameters:

      • endpoint: Enter the endpoint of the region in which your bucket is located. For more information about the endpoint of each region, see Regions and endpoints.

        You can also add http:// or https:// to specify the protocol that ossutil uses to access Object Storage Service (OSS). The default protocol is HTTP. For example, if you want to access a bucket in the China (Shenzhen) region by using HTTPS, set the endpoint to https://oss-cn-shenzhen.aliyuncs.com.

      • accessKeyID and accessKeySecret: Enter the AccessKey pair of your Alibaba Cloud account.
      • stsToken: This option is required only when you use a temporary STS token to access an OSS bucket. Otherwise, you can leave this parameter empty. For more information about how to generate an STS token, see Authorized third-party upload.
    Note For more information about configuration files, see config.

Install ossutil on Windows

  1. Click the download URL listed in the preceding section to download the installation package of ossutil.
  2. Decompress the downloaded installation package. Then, run the ossutil.bat file.
  3. Run the following command to generate a configuration file:
    D:\ossutil>ossutil64.exe config
  4. Configure the configuration file as prompted. You can configure the configuration file in the same way as you generate configuration files in Linux. For more information, see Generate a configuration file in interactive mode.

Install ossutil on macOS

  1. Run the following command to download the ossutil installation package:
    curl -o ossutilmac64 http://gosspublic.alicdn.com/ossutil/1.7.7/ossutilmac64
  2. Run the following command to modify the execution permissions of the file:
    chmod 755 ossutilmac64
  3. Run the following command to generate configurations:
    ./ossutilmac64 config
  4. Configure the configuration file as prompted. You can configure the configuration file in the same way as you generate configuration files in Linux. For more information, see Generate a configuration file in interactive mode.

Install ossutil on ARM systems

  1. Run the following command to download the ossutil installation package:
    wget http://gosspublic.alicdn.com/ossutil/1.7.7/ossutilarm64
  2. Run the following command to modify the execution permissions of the file:
    chmod 755 ossutilarm64
  3. Run the following command to generate a configuration file:
    ./ossutilarm64 config
  4. Configure the configuration file as prompted. You can configure the configuration file in the same way as you generate configuration files in Linux. For more information, see Generate a configuration file in interactive mode.