lstsystems/s3n-browser repository overview

⁠S3n Browser

A lightweight, intuitive web application for accessing and managing content in Amazon S3 storage. Designed for content editors with limited technical AWS knowledge.

⁠Features

• Browse and manage S3 content with an easy-to-use interface
• Direct image preview in browser without downloading
• Generate pre-signed URLs for sharing content
• Upload, download, and delete files with a simple interface

⁠Docker Usage

docker run -p 3000:3000 \
  -e S3_ACCESS_KEY_ID=your_access_key \
  -e S3_SECRET_ACCESS_KEY=your_secret_key \
  -e S3_BUCKET_NAME=your_bucket_name \
  -e S3_REGION=your_region \
  lstsystems/s3n-browser:latest

⁠Environment Variables

⁠Required

• S3_ACCESS_KEY_ID - AWS access key ID
• S3_SECRET_ACCESS_KEY - AWS secret access key
• S3_BUCKET_NAME - Name of the S3 bucket to browse

⁠Optional

• S3_ENDPOINT_URL - Custom endpoint for S3-compatible services
• S3_REGION - AWS region (default: us-east-1)
• S3_FORCE_PATH_STYLE - Whether to use path-style URLs (default: true)
• S3_FILE_UPLOAD_LIMIT - Maximum file size for uploads
• S3_SIGNED_URL_EXPIRES - Expiration time for signed URLs (default: 900s)
• SIGNING_SERVICE_URL - External service for generating signed URLs

⁠Scope and Limitations

• Single bucket access only
• Focused on essential content management tasks
• No support for advanced features like metadata editing or ACLs
• Designed for simplicity and ease of use

⁠Security

Typically deployed behind a reverse proxy for authentication and authorization.

⁠Source Code

View the full source code and documentation at GitHub⁠