Skip to main content

S3

Add or edit connections to Amazon S3 or compatible object storage. After connecting, browse bucket objects and upload, download, create, rename, or delete content.

Add an S3 connection

Page layout​

  1. Top bar: New network or Edit network, with a back button on the left.
  2. Protocol: choose S3 when adding; an existing connection's protocol is fixed.
  3. Basic information: Name and Endpoint.
  4. Authentication: Access Key ID, Secret Access Key, and optional SessionToken.
  5. S3 settings: Bucket, Region, and Force path style as required by the provider.
  6. Actions: save at the bottom right, or use Test connection to validate the fields.

Fields​

  • Name: the name shown in the network list; required when saving.
  • Endpoint: the service address; required and must be a parseable http or https URL. The example is https://s3.us-east-1.amazonaws.com.
  • Access Key ID: required access key identifier.
  • Secret Access Key: required secret access key.
  • SessionToken (optional): needed for temporary credentials.
  • Bucket: the bucket name; required.
  • Region: the bucket's region; required.
  • Force path style: enable when the provider requires path-style access.
  • Save to database: shown for new connections; disable it for a temporary connection only.

Operations​

1. Add an S3 connection​

Select Add in network management and choose S3. Enter the name, endpoint, keys, bucket, and region. Set force path style to match the provider's requirements.

Fill in an S3 configuration

2. Test the connection​

Complete the required fields and select Test connection. A success message indicates the bucket root can be listed. Otherwise, a failure reason is shown.

3. Edit a connection​

Choose Edit from its network-list menu. Update the endpoint, keys, bucket, region, or path-style setting, then save.

Edit an S3 connection

4. Connect and browse objects​

Return to network management, select the S3 entry, and confirm to open the bucket root.

Connected S3 bucket

5. Create a folder in S3​

After connecting, select the bottom-right add button. Enter a name, choose Folder, and select Confirm to create a directory marker.

Create an S3 folder

The new folder appears in the current S3 directory after creation.

New S3 folder in the list

  • Connection troubleshooting: check addresses, authentication, and permissions for each protocol.
  • Files: browse remote directories and work with files after connecting.