diff --git a/protocols/s3/neon.md b/protocols/s3/neon.md new file mode 100644 index 00000000..ada4dc97 --- /dev/null +++ b/protocols/s3/neon.md @@ -0,0 +1,38 @@ +Neon Object Storage +==== + +> [Neon Object Storage](https://neon.com/docs/storage/overview) is S3 compatible object storage included with Neon projects. Each branch has its own storage endpoint. + +## Connecting + +### Connection Profile + +:::{note} +Connection profiles can be installed from *Preferences → Profiles*. +::: + +{download}`Download` the *Neon Object Storage Connection Profile* for preconfigured settings. + +:::{tip} +Set *Server* to the storage endpoint of your branch, like `br-.storage.c-..aws.neon.tech`. In the [Neon Console](https://console.neon.tech/), click *Connect* and open the *Storage* tab to copy the endpoint. +::: + +### Access Keys + +Credentials are scoped to a branch and its child branches. + +1. Log in to the [Neon Console](https://console.neon.tech/) and select your project. +2. Click *Connect* and open the *Storage* tab. +3. Click *Reveal credential* or *Copy credentials*. You can also create a credential with `storage:read` and `storage:write` scopes in *Settings → Credentials*. +4. Enter the token ID (`nak_live_…`) for *Access Key ID* and the secret (`nsk_live_…`) for *Secret Access Key*. + +## Limitations + +- ACLs are read only. Renaming a file fails after the copy because the ACL of the source file cannot be applied to the target. +- Versioning and lifecycle configurations are not enforced. +- Bucket logging, website configuration and transfer acceleration are not supported. + +## References + +- [Neon Object Storage documentation](https://neon.com/docs/storage/overview) +- [S3 compatibility](https://neon.com/docs/storage/s3-compatibility) diff --git a/protocols/s3/providers.md b/protocols/s3/providers.md index 49f6b282..adcef5b1 100644 --- a/protocols/s3/providers.md +++ b/protocols/s3/providers.md @@ -20,6 +20,7 @@ ionos linode mega minio +neon oraclecloud pilvio polycloud @@ -52,4 +53,4 @@ Connection profiles can be installed from *Preferences → Profiles*. - [OVH](../openstack/ovh.md) - [Seeweb](https://www.seeweb.it/) - [Swisscom S3 Dynamic Storage](https://www.swisscom.ch/en/business/enterprise/offer/cloud-data-center/dynamic-computing-services.html) -- [Vultr Object Storage](https://www.vultr.com/docs/vultr-object-storage#Cyberduck_GUI_tool) \ No newline at end of file +- [Vultr Object Storage](https://www.vultr.com/docs/vultr-object-storage#Cyberduck_GUI_tool)