R2 / S3 Compatible Storage

Modern web applications often rely on cloud object storage like Amazon S3 or Cloudflare R2 for storing user uploads, assets, and backups. Testing this locally can be painful without a true compatible interface.

Kythia Workspace includes Minio, a high-performance, S3-compatible object storage server, allowing you to develop and test cloud storage workflows entirely offline.

How to use Minio

Start the Service

Navigate to the S3 Storage tab in the sidebar and click Start Minio. Kythia will handle the downloading and configuration automatically if it's your first time.

Access the Dashboard

Click the Open Web Console button in Kythia (or visit http://localhost:9003) to manage buckets visually. Log in using the default credentials:

Username: kythiaadmin
Password: kythiaadmin

Configure Your App

Set up your application's environment variables to connect to http://localhost:9002 using the kythiaadmin credentials. (See configuration example below).

Example Environment Variables

AWS_ACCESS_KEY_ID=kythiaadmin
AWS_SECRET_ACCESS_KEY=kythiaadmin
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=your-local-bucket-name
AWS_USE_PATH_STYLE_ENDPOINT=true
AWS_ENDPOINT=http://localhost:9002

Important: You must set AWS_USE_PATH_STYLE_ENDPOINT=true (or the equivalent in your SDK) when connecting to Minio locally. AWS S3 uses virtual hosted-style requests by default (bucket.s3.amazonaws.com), whereas Minio locally expects path-style requests (localhost:9000/bucket).

Managing Storage Data

Minio stores all buckets and objects as physical files and folders in your Kythia data directory. You can quickly access these files directly on your computer by clicking the Open Data Folder button in the Kythia UI. This is incredibly useful for inspecting exactly what your application is writing to the disk.