Configuration CLI

This guide covers all configuration options available for the Photosphere CLI tool

Environment Variables

S3/AWS Configuration

Variable	Description	Example
AWS_ACCESS_KEY_ID	S3 access key ID	AKIAIOSFODNN7EXAMPLE
AWS_SECRET_ACCESS_KEY	S3 secret access key	wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
AWS_DEFAULT_REGION	S3 region	us-east-1
AWS_ENDPOINT	S3 endpoint URL (for non-AWS S3)	https://nyc3.digitaloceanspaces.com
S3_PROFILE	Select S3 profile to use	production

Other Environment Variables

Variable	Description	Default
GOOGLE_API_KEY	Google API key for reverse geocoding	None

Configuration Files

S3 Configuration

S3 credentials are stored in an ini file at ~/.config/photosphere/photosphere.conf.

Configuration File Format

[s3]
region=us-east-1
accessKeyId=your-access-key
secretAccessKey=your-secret-key
endpoint=https://syd1.digitaloceanspaces.com

[google]
apiKey=your-google-api-key

Storage Connection Strings

The CLI supports multiple storage backends:

Type	Format	Example
Filesystem	fs:path/to/directory	fs:/var/photosphere/data
Filesystem (implicit)	path/to/directory	./my-photos
S3-compatible	s3:bucket-name/path	s3:my-bucket/photos

Related Configuration

• Configuration-Backend - Backend server configuration
• Configuration-Auth0 - Auth0 authentication setup for server deployments
• Configuration-Digital-Ocean-Spaces - Digital Ocean Spaces setup for S3-compatible storage