<languages />

This page contains instructions on how to set up and access [[Arbutus object storage]] with WinSCP, one of the [[Arbutus_object_storage_clients | object storage clients ]] available for this storage type.

== Installing WinSCP == 
WinSCP can be installed from https://winscp.net/.

== Configuring WinSCP ==
Under "New Session", make the following configurations:
<ul>
<li>File protocol: Amazon S3</li>
<li>Host name: object-arbutus.cloud.computecanada.ca</li>
<li>Port number: 443</li>
<li>Access key ID: 20_DIGIT_ACCESS_KEY</li>
</ul>
and "Save" these settings as shown below

[[File:WinSCP Configuration.png|600px|thumb|center|WinSCP configuration screen]]

Next, click on the "Edit" button and then click on "Advanced..." and navigate to "Environment" to "S3" to "Protocol options" to "URL style:" which <b>must</b> changed from "Virtual Host" to "Path" as shown below:

[[File:WinSCP Path Configuration.png|600px|thumb|center|WinSCP Path Configuration]]

This "Path" setting is important, otherwise WinSCP will not work and you will see hostname resolution errors, like this:
[[File:WinSCP resolve error.png|400px|thumb|center|WinSCP resolve error]]

== Using WinSCP ==
Click on the "Login" button and use the WinSCP GUI to create buckets and to transfer files:

[[File:WinSCP transfers.png|800px|thumb|center|WinSCP file transfer screen]]

== Access Control Lists (ACLs) and Policies ==
Right-clicking on a file will allow you to set a file's ACL, like this:
[[File:WinSCP ACL.png|400px|thumb|center|WinSCP ACL screen]]

[[Category:Cloud]]