How do I install ossutil? - Object Storage Service - Alibaba Cloud Documentation Center

ossutil allows you to efficiently manage objects in Object Storage Service (OSS). For example, you can use ossutil to upload large objects, download objects, and delete objects whose names contain a specific prefix. ossutil supports the following OSs: Windows, Linux, and macOS. You need to download and install an ossutil version that suits your OS.

Version

Latest version: 2.0.5-beta.10291800

Download ossutil

Download link	SHA-256 checksum
Linux x86 32bit	d9882c665f58adfcd356ffffefd9aca0f4b0b3d274fddcd15e92c9fcf78d6896
Linux x86 64bit	136ce27972f2b0bc2fa5fd910621f7301d8279c0c1e2e3b2471768accbd74456
Linux ARM 32bit	0352e171fda33f5b4ab8422363db8c66b5cd7ccbf05b2ab9a921e6d509d6d7cc
Linux ARM 64bit	07aab5b364858fd7254b5209d78da804e6270fd34f1dfffd13d0e7edf9452e51
macOS x86 64bit	00e8ab17a3ab037d28cf61a5c56b2875890ad658225a0e26559c25015faea05a
macOS ARM 64bit	9060dfc1f00bfc52023814fef75b8e1f68ce8e687fadbf51f5407fabae469c40
Windows x86 32bit	9a4dc67f3d274ed844946900b4b6bc7b4010844c1bca17a4862c90e45736a7cb
Windows x86 64bit	ba44ceffa9d42dd159f0d3bf65ce20084e98355cfce3749f7e2f472f500284a8
Windows 7, Windows 8, Windows Server 2008R2	b286710a4d7308187743b23487fc23fb5f1740aa5c080efe42321f1ea8aaea93

Install ossutil

Linux

Install ossutil.
1. Download the ossutil package.
```
curl -o ossutil-2.0.5-beta.11291800-linux-amd64.zip https://gosspublic.alicdn.com/ossutil/v2-beta/2.0.5-beta.11291800/ossutil-2.0.5-beta.11291800-linux-amd64.zip
```
  Note
  The command downloads ossutil for a 64-bit Linux x86 system. To download ossutil for another system, see Download ossutil.
2. Go to the directory in which the ossutil package is stored and execute the following unzip command.
```
unzip ossutil-2.0.5-beta.11291800-linux-amd64.zip
```
3. Enter the ossutil-2.0.5-beta.11291800-linux-amd64 directory.
```
cd ossutil-2.0.5-beta.11291800-linux-amd64
```
4. Execute the following command in the current directory.
```
chmod 755 ossutil
```
5. Execute the following command for global invocation of ossutil.
```
sudo mv ossutil /usr/local/bin/ && sudo ln -s /usr/local/bin/ossutil /usr/bin/ossutil
```
6. Execute the following command to check whether ossutil is installed.
```
ossutil
```
  If the help information of ossutil is displayed, ossutil is installed.
Configure ossutil.
1. Execute the following command to configure ossutil.
```
ossutil config
```
2. Follow the on-screen instructions to configure the path of the configuration file. You can press the Enter key to use the default path.
```
Please enter the config file name,the file name can include path(default /root/.ossutilconfig, carriage return will use the default file. If you specified this option to other file, you should specify --config-file option to the file when you use other commands):
```
  By default, ossutil uses ~/.ossutilconfig as the configuration file. If you specify a different configuration file, you must add the -c option to specify the configuration file every time you execute a command. For example, if you save the configuration file as /home/config, add the -c option in the following format when you execute the ls command:
```
ossutil ls oss://examplebucket -c /home/config
```
3. Configure the AccessKey ID, AccessKey Secret, and Region parameters based on the on-screen instructions.
  Enter the AccessKey ID that you created.
```
Please enter Access Key ID [****************id]:LTAI****************
```
  Enter the AccessKey Secret that you created.
```
Please enter Access Key Secret [****************sk]:R6vg*********************
```
  Enter the region in which the bucket that stores your data is located. Default value: cn-hangzhou.
```
Please enter Region [cn-hangzhou]:cn-hangzhou
```
  In this topic, the China (Hangzhou) region is used. For more information, see Regions and endpoints.

Windows

Install ossutil.
1. Click Windows x86 64bit, Windows x86 32bit or Windows x86 64bit to download the ossutil installation package based on the configurations of your computer.
2. Decompress the installation package. Then, run the ossutil.exe file.
3. Execute the following command to check whether ossutil is installed.
```
ossutil
```
  If the help information of ossutil is displayed, ossutil is installed.
Configure ossutil.
1. Execute the following command to configure ossutil.
```
ossutil config
```
2. Follow the on-screen instructions to configure the path of the configuration file. You can press the Enter key to use the default path.
```
Please enter the config file name,the file name can include path(default "C:\Users\issuser\.ossutilconfig", carriage return will use the default file. If you specified this option to other file, you should specify --config-file option to the file when you use other commands):
```
  By default, ossutil uses ~\.ossutilconfig as the configuration file. If you specify a different configuration file, you must add the -c option to specify the configuration file every time you execute a command. For example, if you save the configuration file as c:\ossutil\config, add the -c option in the following format when you execute the ls command:
```
ossutil ls oss://examplebucket -c c:\ossutil\config
```
3. Configure the AccessKey ID, AccessKey Secret, and Region parameters based on the on-screen instructions.
  Enter the AccessKey ID that you created.
```
Please enter Access Key ID [****************id]:LTAI****************
```
  Enter the AccessKey Secret that you created.
```
Please enter Access Key Secret [****************sk]:R6vg*********************
```
  Enter the region in which the bucket that stores your data is located. Default value: cn-hangzhou.
```
Please enter Region [cn-hangzhou]:cn-hangzhou
```
  In this topic, the China (Hangzhou) region is used. For more information, see Regions and endpoints.

macOS

Install ossutil.
1. Download the ossutil package.
```
curl -o ossutil-2.0.5-beta.11291800-mac-arm64.zip  https://gosspublic.alicdn.com/ossutil/v2-beta/2.0.5-beta.11291800/ossutil-2.0.5-beta.11291800-mac-arm64.zip
```
  Note
  The command downloads ossutil for a 64-bit macOS ARM system. For more information about how to download ossutil for other operating systems, see Download ossutil.
2. Go to the directory in which the ossutil package is stored and execute the following unzip command.
```
unzip ossutil-2.0.5-beta.11291800-mac-arm64.zip
```
3. Enter the ossutil-2.0.5-beta.11291800-mac-arm64 directory.
```
cd ossutil-2.0.5-beta.11291800-mac-arm64
```
4. Execute the following command in the current directory.
```
chmod 755 ossutil
```
5. Execute the following command for global invocation of ossutil.
```
sudo mv ossutil /usr/local/bin/ && sudo ln -s /usr/local/bin/ossutil /usr/bin/ossutil
```
6. Execute the following command to check whether ossutil is installed.
```
ossutil
```
  If the help information of ossutil is displayed, ossutil is installed.
Configure ossutil.
1. Execute the following command to configure ossutil.
```
ossutil config
```
2. Follow the on-screen instructions to configure the path of the configuration file. You can press the Enter key to use the default path.
```
Please enter the config file name,the file name can include path(default "/Users/user/.ossutilconfig", carriage return will use the default file. If you specified this option to other file, you should specify --config-file option to the file when you use other commands): 
```
  By default, ossutil uses ~/.ossutilconfig as the configuration file. If you specify a different configuration file, you must add the -c option to specify the configuration file every time you execute a command. For example, if you save the configuration file as /home/config, add the -c option in the following format when you execute the ls command:
```
ossutil ls oss://examplebucket -c /home/config
```
3. Configure the AccessKey ID, AccessKey Secret, and Region parameters based on the on-screen instructions.
  Enter the AccessKey ID that you created.
```
Please enter Access Key ID [****************id]:LTAI****************
```
  Enter the AccessKey Secret that you created.
```
Please enter Access Key Secret [****************sk]:R6vg*********************
```
  Enter the region in which the bucket that stores your data is located. Default value: cn-hangzhou.
```
Please enter Region [cn-hangzhou]:cn-hangzhou
```
  In this topic, the China (Hangzhou) region is used. For more information, see Regions and endpoints.