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

Version and runtime environment

  • Current version: 1.7.13
  • 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

ossutil 1.7.8 is compiled by using Go 1.16. ossutil does not support the macOS x86 32-bit operating system. ossutil version 1.7.8 or later no longer provides the ossutilmac32 installation package.

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 https://gosspublic.alicdn.com/ossutil/1.7.13/ossutil64                           
    Notice When you specify the URLs in the wget command to download the ossutil installation package, delete ?spm=xxxx from the URLs.
  2. Run the following command to modify the execution permissions of the ossutil installation package:
    chmod 755 ossutil64
  3. Generate a configuration file in interactive mode.
    1. Run the following command:
      ./ossutil64 config
    2. Follow the on-screen instructions to configure the path of the configuration file.

      We recommend that you press the Enter key to use the default path of the configuration file.

      Enter the name of the configuration file. The file name can contain the file path. The default path is /home/user/.ossutilconfig. If you press the Enter key, the file is generated in the default path. 
      If you want to store the file in another path, set the --config-file option to the path. 
      By default, ossutil uses /home/user/.ossutilconfig as the configuration file. If you specify the path of the configuration file, 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. Follow the on-screen instructions to configure the interface language of ossutil.

      Enter CH or EN. By default, the interface of ossutil is in the language that is used by the operating system. The configuration takes effect after you run the config command.

    4. Follow the on-screen instructions to configure the following parameters: endpoint, accessKeyID, accessKeySecret, and stsToken.

      Parameter description:

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

        You can also add http:// or https:// to specify the protocol that you want ossutil to use 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: Specify the AccessKey pair of your Alibaba Cloud account.
      • stsToken: This parameter is required only when you use temporary access credentials to access an OSS bucket. If you do not use temporary access credentials to access an OSS bucket, you can leave this parameter empty. For more information about how to generate an STS token, see the "Temporary access credential" section in Authorized third-party upload.
    Note For more information about the configuration file, see config.

Install ossutil on Windows

  1. Click the download URL to download the ossutil installation package.
  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. Follow the on-screen instructions to configure the configuration file. You can configure the configuration file in the same manner as you configure the configuration file 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 https://gosspublic.alicdn.com/ossutil/1.7.13/ossutilmac64
  2. Run the following command to modify the execution permissions of the ossutil installation package:
    chmod 755 ossutilmac64
  3. Run the following command to generate a configuration file:
    ./ossutilmac64 config
  4. Follow the on-screen instructions to configure the configuration file. You can configure the configuration file in the same manner as you configure the configuration file in Linux. For more information, see Generate a configuration file in interactive mode.

Install ossutil on ARM

  1. Run the following command to download the ossutil installation package:
    wget https://gosspublic.alicdn.com/ossutil/1.7.13/ossutilarm64
  2. Run the following command to modify the execution permissions of the ossutil installation package:
    chmod 755 ossutilarm64
  3. Run the following command to generate a configuration file:
    ./ossutilarm64 config
  4. Follow the on-screen instructions to configure the configuration file. You can configure the configuration file in the same manner as you configure the configuration file in Linux. For more information, see Generate a configuration file in interactive mode.