Integration & CLI Configuration Guide
Nordic Data Sync exposes strict AWS Signature Version 4 endpoints over TLS 1.3 (HTTP/2 and QUIC HTTP/3). Configure your existing backup daemons in minutes with zero proprietary agents.
1. Regional S3v4 Ingest Endpoints
Select the endpoint matching your bucket residency policy. Dual-Region Geo-Sync buckets accept writes on either se.nordicdatasync.com or the global anycast router nordicdatasync.com:
| Region Code | HTTPS / QUIC Endpoint | Jurisdiction |
|---|---|---|
eu-north-1 | https://se.nordicdatasync.com | Stockholm, Sweden (EU) |
eu-north-2 | https://fi.nordicdatasync.com | Helsinki, Finland (EU) |
eu-central-1 | https://de.nordicdatasync.com | Frankfurt, Germany (EU) |
cis-west-1 | https://yc.nordicdatasync.com | Moscow Edge Gateway (Transit) |
2. Standard AWS CLI v2 & Immutable Object Lock
Configure a named profile in ~/.aws/config and enforce a 30-day hardware WORM compliance retention policy so ransomware or compromised admin credentials cannot delete snapshots:
[profile nordic]
region = eu-north-1
endpoint_url = https://se.nordicdatasync.com
s3 =
signature_version = s3v4
addressing_style = path
max_concurrent_requests = 24
multipart_threshold = 64MB
multipart_chunksize = 16MB
checksum_validation = when_required
aws --profile nordic s3api create-bucket \
--bucket prod-ledger-immutable \
--object-lock-enabled-for-bucket
aws --profile nordic s3api put-object-lock-configuration \
--bucket prod-ledger-immutable \
--object-lock-configuration '{
"ObjectLockEnabled": "Enabled",
"Rule": { "DefaultRetention": { "Mode": "COMPLIANCE", "Days": 30 } }
}'
3. PostgreSQL 14–17 Continuous PITR (pgBackRest)
Stream Zstandard-compressed 16 MB WAL segments asynchronously from PostgreSQL primaries to Stockholm NVMe journals:
[global] repo1-type=s3 repo1-s3-endpoint=se.nordicdatasync.com repo1-s3-bucket=pg17-prod-cluster-01 repo1-s3-region=eu-north-1 repo1-s3-uri-style=path repo1-path=/pgbackrest repo1-retention-full=4 repo1-retention-diff=14 repo1-cipher-type=aes-256-cbc repo1-cipher-pass=REPLACE_WITH_32B_OPENSSL_RAND_BASE64 compress-type=zst compress-level=6 process-max=12 archive-async=y [main] pg1-path=/var/lib/postgresql/17/main
# In postgresql.conf: archive_mode = on archive_command = 'pgbackrest --stanza=main archive-push %p' wal_level = replica max_wal_senders = 10
4. High-Throughput WAL-G Configuration
For cloud-native PostgreSQL containers (Patroni / Stolon) using wal-g with libsodium / Brotli or LZ4 streaming:
export AWS_ACCESS_KEY_ID="NDS_AKIA_WALG_AGENT" export AWS_SECRET_ACCESS_KEY="nds_scoped_secret_token" export AWS_ENDPOINT="https://se.nordicdatasync.com" export AWS_REGION="eu-north-1" export AWS_S3_FORCE_PATH_STYLE="true" export WALG_S3_PREFIX="s3://pg-patroni-eu01/walg" export WALG_COMPRESSION_METHOD="zstd" export WALG_UPLOAD_CONCURRENCY="16" export WALG_LIBSODIUM_KEY_PATH="/etc/wal-g/secret.key" wal-g backup-push /var/lib/postgresql/data wal-g backup-list --detail
5. Deduplicated Encrypted Host Snapshots (Restic & Kopia)
Initialize a zero-knowledge content-defined chunking repository and schedule hourly snapshots with automatic retention pruning:
export AWS_ACCESS_KEY_ID="NDS_AKIA_HOST_BACKUP" export AWS_SECRET_ACCESS_KEY="nds_secret_key_material" export RESTIC_REPOSITORY="s3:https://fi.nordicdatasync.com/srv-snapshots-hel2" export RESTIC_PASSWORD_FILE="/etc/restic/repo.key" restic init restic backup /srv /etc /var/vmail --exclude-caches --compression max -o s3.connections=16 restic forget --keep-hourly 24 --keep-daily 14 --keep-monthly 12 --prune
6. Kubernetes Cluster Disaster Recovery (Velero)
Protect StatefulSet persistent volumes and cluster manifests across namespaces using the official AWS Velero plugin:
velero install \ --provider aws \ --plugins velero/velero-plugin-for-aws:v1.10.0 \ --bucket k8s-prod-etcd-backups \ --secret-file ./credentials-nordic \ --use-node-agent \ --backup-location-config region=eu-north-1,s3ForcePathStyle="true",s3Url=https://se.nordicdatasync.com velero schedule create prod-hourly --schedule="15 * * * *" --ttl 720h0m0s
7. Terraform / OpenTofu S3 State Backend with Native Locking
Nordic Data Sync supports conditional If-None-Match: "*" writes required by Terraform 1.10+ and OpenTofu native S3 state locking without DynamoDB:
terraform {
backend "s3" {
bucket = "infra-tfstate-vault"
key = "prod/eu-north/terraform.tfstate"
region = "eu-north-1"
endpoints = { s3 = "https://se.nordicdatasync.com" }
use_lockfile = true
skip_credentials_validation = true
skip_region_validation = true
skip_requesting_account_id = true
use_path_style = true
}
}
8. Append-Only IAM Service Key Policy (Anti-Ransomware)
Bind production database hosts to an append-only policy restricted to your server ASN so a compromised host cannot enumerate or delete historical backups:
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": ["s3:PutObject", "s3:AbortMultipartUpload"],
"Resource": "arn:aws:s3:::pg17-prod-cluster-01/*",
"Condition": {
"IpAddress": { "aws:SourceIp": ["198.51.100.0/24"] }
}
}
]
}
9. Prometheus OpenMetrics Scraping & Dead-Man Alerting
Scrape real-time bucket size, replication lag, and newest object timestamp using a read-only telemetry token:
scrape_configs:
- job_name: "nordic_data_sync"
scheme: https
metrics_path: /v1/prometheus/metrics
bearer_token_file: /etc/prometheus/nordic_metrics.token
static_configs:
- targets: ["nordicdatasync.com"]