Use object storage

You'll store a file in pogi and get it back, using S3, Cloud Storage or Blob Storage. Each section uses the command-line tool for that cloud.

Before you startCopy Anchor Link

• Run pogi start in another terminal.

• Load the settings that point your tools at pogi:

  Copy Text

  eval "$(pogi env)"

• Install the tools for the sections you use: the AWS CLI, gcloud and the Azure CLI (az). Azure Blob Storage listens on port 10000, the same as Azurite.

• Make a file to upload:

  Copy Text

  echo "hello from pogi" > hello.txt

AWS: S3Copy Anchor Link

You'll make a bucket, upload a file, list it, download it, and fetch it again with a presigned URL (a link that works without credentials for a short time).

1. Make a bucket and upload the file:

   Copy Text

   aws s3 mb s3://demo
   aws s3 cp hello.txt s3://demo/hello.txt --no-progress

   make_bucket: demo
   upload: ./hello.txt to s3://demo/hello.txt

2. List the bucket:

   Copy Text

   aws s3 ls s3://demo

   2026-10-26 00:06:26         16 hello.txt

3. Download the file under a new name and read it:

   Copy Text

   aws s3 cp s3://demo/hello.txt copy.txt --no-progress
   cat copy.txt

   download: s3://demo/hello.txt to ./copy.txt
   hello from pogi

4. Make a presigned URL and fetch it with curl:

   Copy Text

   URL=$(aws s3 presign s3://demo/hello.txt --expires-in 300)
   curl -s "$URL"

   hello from pogi

Google Cloud: Cloud StorageCopy Anchor Link

You'll do the same with gcloud storage. --no-user-output-enabled turns off the progress text that gcloud prints while it copies.

1. Make a bucket:

   Copy Text

   gcloud storage buckets create gs://demo-gcs

   Creating gs://demo-gcs/...

2. Upload the file. It prints nothing:

   Copy Text

   gcloud storage cp hello.txt gs://demo-gcs/hello.txt --no-user-output-enabled

3. List the bucket:

   Copy Text

   gcloud storage ls gs://demo-gcs

   gs://demo-gcs/hello.txt

4. Download the file and read it:

   Copy Text

   gcloud storage cp gs://demo-gcs/hello.txt copy-gcs.txt --no-user-output-enabled
   cat copy-gcs.txt

   hello from pogi

Azure: Blob StorageCopy Anchor Link

az storage works with the connection string that pogi env sets in AZURE_STORAGE_CONNECTION_STRING. It doesn't need az login.

1. Make a container:

   Copy Text

   az storage container create --name demo

   {
     "created": true
   }

2. Upload the file. --output none and --no-progress keep it quiet, so it prints nothing:

   Copy Text

   az storage blob upload --container-name demo --name hello.txt --file hello.txt --no-progress --output none

3. List the blobs:

   Copy Text

   az storage blob list --container-name demo --query "[].name" --output tsv

   hello.txt

4. Download the blob and read it:

   Copy Text

   az storage blob download --container-name demo --name hello.txt --file copy-az.txt --no-progress --output none
   cat copy-az.txt

   hello from pogi

LimitsCopy Anchor Link

• S3: an upload over 10 MiB is refused unless you start pogi with a larger --max-upload-mb, because pogi holds object bodies in memory. That holds in persistent mode too.
• S3 replication settings are stored but not acted on. Lifecycle transitions are ignored, and so are website routing rules. S3 Select is not available.
• Cloud Storage does not support IAM conditions or retention policies yet.

Each service's row on the coverage page lists the rest: S3, Cloud Storage and Blob Storage.

See alsoCopy Anchor Link

• Connect your tools
• Use queues and topics
• Use any service
• Coverage