A modern, zero-retention S3 bucket browser with a clean interface. View and download files from your S3 buckets without storing any data on the server.

Features

📁 Browse S3 buckets with folder-like navigation
🔍 Real-time search functionality
⬇️ Secure file downloads using signed URLs
📱 Responsive design with PicoCSS
⚡ Fast navigation using HTMX
🔒 No server-side storage of credentials or files

Quick Start

Using Deno

Set your AWS credentials as environment variables:

export S3_BUCKET="your-bucket"
export S3_REGION="your-region"
export AWS_ACCESS_KEY_ID="your-key"
export AWS_SECRET_ACCESS_KEY="your-secret"

Install Deno if you haven't already:

curl -fsSL https://deno.land/x/install/install.sh | sh

Run the application:

# Development mode with hot reload
deno task dev

# Production mode
deno task start

Using Docker

Build the image:

docker build -t s3panoramic .

Run the container:

docker run -p 3000:3000 \
  -e S3_BUCKET="your-bucket" \
  -e S3_REGION="your-region" \
  -e AWS_ACCESS_KEY_ID="your-key" \
  -e AWS_SECRET_ACCESS_KEY="your-secret" \
  s3panoramic

Open http://localhost:3000 in your browser.

Authorisation / Authentication

This application does not perform authentication or authorisation of users. I recommend using a proxy such as oauth2-proxy to protect your files from unauthorised access.