Bucket Locations | Tigris Object Storage Documentation

Overview

A bucket's location defines how and where your object data is stored. You choose a location type when you create a bucket, and it determines the data placement, replication behavior, availability, and consistency model for all objects in that bucket.

Tigris supports four bucket location types:

Location Type Description
Global Data distributed globally (default)
Multi-region Highest availability across regions in a chosen geography
Dual-region High availability across specific regions of your choice
Single-region Data redundancy across availability zones in one region

Location Types

Global

Global is the default location type and is unique to Tigris. Data is distributed globally and automatically stored closest to the request origin. As access patterns change, data migrates to where it's most frequently needed.

Property Detail
Data Placement Single copy, distributed globally based on access patterns
Availability Data follows your users — accessible from any region
Consistency Strong consistency for requests in the same region. Eventual consistency globally.
Replication Metadata pushed to all regions. Data pulled on demand and cached locally.

How it works:

  1. When you upload an object, it is stored in the region nearest to the upload origin.
  2. Metadata is replicated to all Tigris regions.
  3. When the object is accessed from a different region, a local copy is created in that region automatically.
  4. Over time, data migrates to regions where it's accessed most frequently.

Best for: Global applications with distributed users, media delivery, and any use case where you want zero-configuration global performance.

Global is the default location type. If you create a bucket without specifying a location type, it will be Global.

Multi-Region

Multi-region provides the highest availability by maintaining two or more copies of your data across regions within a chosen geography. You select the geography (USA or EUR) when creating the bucket — Tigris automatically selects the regions within that geography where data is stored.

Property Detail
Data Placement Data residency across 2+ regions in the chosen geography
Availability Highest — survives individual regional failures within the geography
Consistency Strong consistency globally
Replication Data is replicated across regions within the geography

Supported geographies:

Geography Candidate Regions
USA sjc (San Jose), ord (Chicago), iad (Ashburn)
EUR ams (Amsterdam), fra (Frankfurt)

Best for: Mission-critical data requiring the highest availability, enterprise workloads where regional failures cannot cause downtime, and applications that need strong consistency globally with geographic redundancy.

Dual-Region

Dual-region provides high availability by maintaining data residency across specific regions of your choice. Unlike multi-region, you have explicit control over exactly which regions store your data.

Property Detail
Data Placement Data residency across your chosen regions
Availability High — survives single region failure
Consistency Strong consistency for requests in the same region. Eventual consistency globally.
Replication Data is replicated between the chosen regions

Region pairing: You can pair any two Tigris regions. Common examples:

Use Case Region Pair
EU data residency with redundancy fra + ams
EU with UK coverage lhr + fra
US East-West redundancy iad + sjc
US with low-latency failover iad + ord
Cross-continent (Americas + Asia) sjc + sin

Best for: Compliance or policy requirements that mandate data residency in specific regions. If your primary goal is geographic redundancy without a strict two-region constraint, consider multi-region for higher availability, stronger consistency, and better cost-effectiveness.

Single-Region

Single-region stores your data with redundancy across availability zones within a single region. This gives you full control over data residency while maintaining durability within the region.

Property Detail
Data Placement Redundant across availability zones in one region
Availability Standard — single region availability
Consistency Strong consistency globally
Replication Redundancy within the region's availability zones

You can find the list of available regions in the Regions Reference.

Best for: Strict data residency and sovereignty requirements, cost optimization for region-local workloads, and applications where compute and storage are co-located in the same region.

Choosing a Location Type

Decision Guide

Your requirement Recommended location type
Global users, lowest latency everywhere, zero configuration Global
Highest availability, strong consistency globally Multi-region
Geographic redundancy at the best price Multi-region
Mission-critical, cannot tolerate regional outages Multi-region
Strict data residency in a single geography Single-region
Compliance requiring data in specific regions Dual-region

For most workloads that need geographic redundancy, we recommend multi-region over dual-region. Multi-region provides higher availability, strong global consistency, and is typically more cost-effective. Choose dual-region only when compliance or policy requires data in specific regions.

Consistency Model Summary

Location Type Same-region requests Cross-region requests
Global Strong consistency Eventual consistency
Multi-region Strong consistency Strong consistency
Dual-region Strong consistency Eventual consistency
Single-region Strong consistency Strong consistency

Availability Comparison

Location Type Failure tolerance
Multi-region Survives regional failures within geography
Dual-region Survives failure of one of the regions
Global Data accessible from any surviving region
Single-region Availability zone redundancy within region

Considerations

Performance

Compliance and Data Residency

Cost