Creating a bucket
Open the create bucket flow
Log in to the Latitude.sh dashboard and navigate to Storage > Object storage in the sidebar. Click Create bucket.
Choose a storage class
Select the storage class for your bucket (for example, Standard). The storage class determines the bucket’s performance characteristics and pricing.
Choose a location
Pick the region and site where the bucket should live. Bucket data stays in the location you select.
Configure the bucket
Enter a Bucket name (see naming rules below). Optionally enable Versioning to keep object history, and Object lock to enforce write-once-read-many retention. Object lock requires versioning and lets you set a retention mode and period.
Versioning and object lock
Versioning
Versioning preserves every version of an object in your bucket, so deletes and overwrites can be recovered by restoring a prior version. Enable it when you want a safety net against accidental changes or deletions.Once versioning is enabled on a bucket, it cannot be disabled.
Object lock (WORM)
Object lock makes objects immutable for a retention period — write-once-read-many. Until the retention expires, the object cannot be deleted or modified, even by the bucket owner. Use it for regulatory compliance, audit trails, and protection against ransomware or accidental data loss. Two retention modes are available:- GOVERNANCE — Objects stay immutable until the retain-until date, but users with specific IAM permissions can override the lock.
- COMPLIANCE — Objects stay immutable until the retain-until date and the lock cannot be reversed by any user, regardless of permissions.
Bucket naming rules
Bucket names must follow these requirements:- Be between 3 and 63 characters long
- Start with a lowercase letter or number
- Contain only lowercase letters, numbers, dots (.), and hyphens (-)
- Be globally unique
Connecting to Object storage
Use any S3-compatible tool or library to interact with your buckets.Connection details
Find your connection details in the Object storage sidebar:- Account ID: Your unique account identifier
- S3 API endpoint: The endpoint URL for S3 API requests. The format depends on the storage class:
- Standard:
https://<account-id>.s3.latitude.sh - High performance:
https://objects.<region>.storage.sh(for example,https://objects.nyc.storage.sh)
- Standard:
Bucket credentials
Each bucket gets an access key and secret key automatically when it’s created, shown on the bucket detail page immediately after. The access key and endpoint remain visible on the bucket detail page after refresh, but the secret key does not.Access keys
Access keys are project-scoped credentials that aren’t tied to a single bucket’s creation. To create one, navigate to the Access keys tab on the Object storage page and click Create access key. This requires a verified team and at least one existing bucket.Choose a storage class and region
The key applies to buckets of the selected storage class in the selected region.
Choose an access scope
- Full access — read and write across all buckets of the selected storage class.
- Limited — scope the key to specific buckets, each set to Read-only or Read-write.
Monitoring usage
The Object storage dashboard displays the following metrics:Overview metrics
- Total Storage: Total amount of data stored across all buckets
- Total Objects: Number of objects stored across all buckets
- Class A Operations: Write operations including PUT, POST, DELETE, and LIST requests
- Class B Operations: Read operations including GET and HEAD requests