Configuration Cloud Storage

Cloud Storage (S3) — Setup and Configuration

Photosphere supports S3-compatible storage for both local and cloud deployments. You can use AWS S3, DigitalOcean Spaces, MinIO, or any S3-compatible service.

For detailed instructions on setting up Digital Ocean Spaces, see Configuration-Digital-Ocean-Spaces.

Configuring S3 Credentials

Use the secrets add command to store your S3 credentials and Google API key:

psi secrets add

Alternatively, set AWS credentials using environment variables:

export AWS_ACCESS_KEY_ID=<your-access-key-id>
export AWS_SECRET_ACCESS_KEY=<your-secret-key>
export AWS_REGION=us-east-1 # Set this to us-east-1 for Digital Ocean.
export AWS_ENDPOINT=https://syd1.digitaloceanspaces.com # If using Digital Ocean, replace with the endpoint for your DO data center.

Using S3 Storage

Once configured, you can use S3 paths directly in commands:

# Replicate a local database to S3
psi replicate --db my-photos --dest s3:my-bucket/photos

# Initialize an empty database in S3
psi init --db s3:my-bucket/photos

# Add files to S3-backed database
psi add --db s3:my-bucket/photos ~/Pictures/*.jpg

Clearing Configuration

To remove stored credentials, use psi secrets delete and select the secret to remove.