> For the complete documentation index, see [llms.txt](https://docs.hedge.video/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hedge.video/offshoot/features/s3-transfers/configuring-connections.md).

# Configuring Connections

{% hint style="info" %}
You'll need to restart OffShoot to apply any changes made with these commands.
{% endhint %}

Connections are stored in these keys:

* `S3AwsConnections`
* `S3GenericConnections`

A connection is structured using the following JSON format:

```json
[
  {
    "path" : "",
    "label" : "",
    "endpoint" : "https://s3.eu-central-1.amazonaws.com",
    "bucket_name" : "bucket-name",
    "accessKey" : "ACCESSKEY"
  }
]
```

## Creating a connection

You can create an AWS S3 connection from a JSON file using the structure listed above with the following Terminal command:

{% code overflow="wrap" %}

```sh
defaults write nl.syncfactory.Hedge.Mac S3AwsConnections -string "$(cat /path/to/file.json)"
```

{% endcode %}

The connection's `Secret Access Key` is stored in the login Keychain as an Application password item, which you can create with the following command:

{% code overflow="wrap" %}

```sh
sudo security add-generic-password -a "ACCESSKEY" -s "https://s3.eu-central-1.amazonaws.com/bucket-name" -l "https://s3.eu-central-1.amazonaws.com" -w "secret-access-key" -T "/Applications/OffShoot.app"
```

{% endcode %}

<figure><img src="/files/twrd9GyC5hrCai7IS1Vr" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Although OffShoot was allowed access when creating the keychain item, permissions must be allowed again. Please let us know if you discover how to fix this issue.
{% endhint %}

<figure><img src="/files/lKG11CVwoPwOU4EjpQlH" alt=""><figcaption></figcaption></figure>

## Checking existing AWS S3 locations

```sh
defaults read nl.syncfactory.Hedge.Mac S3AwsConnections
```

## Write current S3 connections to a JSON file

(For backing up or editing the JSON file.)

```sh
defaults read nl.syncfactory.Hedge.Mac S3AwsConnections > `/path/to/jsonname.json`
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.hedge.video/offshoot/features/s3-transfers/configuring-connections.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.