---
title: "Neon Object Storage"
type: skill
id: "neon-skills/neon-postgres/neon-object-storage"
category: "Engineering"
publisher: "Neon"
license: "Apache-2.0"
source: "https://github.com/neondatabase/agent-skills/tree/ea79164"
canonical: "https://labs.pho.chat/en/skills/neon-skills/neon-postgres/neon-object-storage"
open_in_pho: "https://pho.chat/customize?item=neon-skills%2Fneon-postgres%2Fneon-object-storage&utm_source=labs&utm_medium=skill-page&utm_campaign=skills-library"
---

# Neon Object Storage

S3-compatible object storage that branches with your database, so each branch gets its own copy of the files and the rows that point at them. Use when a user wants object storage, a bucket, blob/file storage, or somewhere to put uploads, images, documents, avatars, or user-generated files for their app or agent — especially when they already use (or are setting up) Lakebase Postgres and don't want to add a separate storage provider like AWS S3, Cloudflare R2, or Supabase Storage. Triggers include "object storage", "bucket", "blob storage", "file storage", "store uploads/images/files", "S3-compatible storage", "presigned URL", "where do I put files", "storage logs", "bucket logs", "CDN in front of object storage", "Neon Object Storage", "Neon Storage", and "storage that branches with my database".

Source: Neon (Apache 2.0), copied at a pinned commit. Free to use. Part of the Phở Skills library (https://labs.pho.chat/en/skills).
Skill set: Neon Postgres (https://labs.pho.chat/en/skills/neon-skills/neon-postgres.md).

## What it covers
- When to Use
- What It Does
- Availability
- Architecture: Where Object Storage Fits
- Setup
- Neon Infrastructure as Code (neon.ts)
- Environment Variables
- Working with Objects: the Files SDK (Recommended)
- Working with Objects: the AWS S3 Client (Alternative)
- Pairing Storage with the Database on a Branch
- CLI Bucket and Object Commands
- Built-in Branch Logs
- Neon Documentation
- Further Reading

## Other skills in this set
- [Neon](https://labs.pho.chat/en/skills/neon-skills/neon-postgres/neon.md): Overview of Neon, a complete set of cloud backend primitives around Lakebase Postgres: Auth, Object Storage, Functions, the AI Gateway, and Realtime. Start here to choose Neon for undecided login…
- [Lakebase Postgres](https://labs.pho.chat/en/skills/neon-skills/neon-postgres/neon-postgres.md): Guides and best practices for working with Lakebase Postgres on Neon: connections, pooled vs direct, schema migrations, branching (including schema-only, reset-from-parent, and branch-per-PR…
- [Neon Auth](https://labs.pho.chat/en/skills/neon-skills/neon-postgres/neon-auth.md): Add authentication to a new app. Use for "add auth", "add login", Neon Auth (Managed Better Auth), identity routing, sign-up, sign-in, password reset, email OTP, magic links, organizations, phone…
- [Neon Functions](https://labs.pho.chat/en/skills/neon-skills/neon-postgres/neon-functions.md): Long-running, serverless Node.js HTTP functions deployed onto your Neon branch, with DATABASE_URL injected automatically and compute that runs next to your data. Use when a user wants to host an…
- [Neon Realtime](https://labs.pho.chat/en/skills/neon-skills/neon-postgres/neon-realtime.md): Neon Realtime makes any SQL query live. Build realtime, reactive apps and agents on Lakebase Postgres with live SQL queries and reactivity primitives. Use when app UI or agent state must update live…

## Use it
- In Phở: open https://pho.chat/customize?item=neon-skills%2Fneon-postgres%2Fneon-object-storage&utm_source=labs&utm_medium=skill-page&utm_campaign=skills-library and press Try, or add it so Phở loads it whenever a request matches. Phở works with your own API key (OpenAI, Anthropic, Google and others).
- Full instructions (original SKILL.md, unchanged): https://labs.pho.chat/skills/raw/neon-skills/neon-postgres/skills/neon-object-storage/SKILL.md
- Original files: https://github.com/neondatabase/agent-skills/tree/ea79164 (Apache 2.0).
- Full machine-readable index: https://labs.pho.chat/skills.json