HomePlatformSDKRelease Notesllms.txt
Launching the Platform/Self-hosted: On-prem/Prerequisites

Redis cache

Setup and configure Redis cache for your self-hosted platform

Overview

Purpose

  • Session management
  • Real-time features
  • Caching layer
  • Performance optimization

Key Features

  • Fast in-memory storage
  • Data persistence
  • High availability
  • Monitoring capabilities

Deployment options

Cloud Provider Options

Google Cloud Memorystore

  • Go to Google Cloud Console
  • Enable Memorystore for Redis API
  • Create new Redis instance:
    • Choose Basic tier for standard workloads
    • Select region (same as your GKE cluster)
    • Set memory capacity (minimum 1GB)
    • Enable authentication (recommended)
  • Configure VPC network and authorized networks

Redis Cloud

  • Create account at Redis Cloud
  • Create new subscription:
    • Fixed plan (minimum 1GB)
    • Choose region
    • Enable password protection
  • Create database with default settings

Digital Ocean Redis

  • Access Digital Ocean Console
  • Create Database > Redis
  • Configure:
    • Choose smallest plan
    • Select datacenter
    • Enable eviction policy

Benefits

  • Automatic backups
  • High availability
  • Security patches
  • Performance monitoring

Requirements

Minimum Specifications

  • Redis 6.0 or higher
  • 1GB memory
  • Network access from platform
  • Password protection enabled

  • Persistence enabled
  • Automatic backups
  • Monitoring setup
  • Eviction policies configured

Information collection

Required values for platform installation

  • Redis hostname/endpoint
  • Port number (default: 6379)
  • Password (if authentication enabled)
  • TLS enabled/disabled
redis:
  host: "" # Redis host collected in prerequisites
  port: 6379 # Redis port collected in prerequisites
  password: "" # Redis password collected in prerequisites
  prefix: "sm" # In shared redis servers, this separates queues
  tls: false # Set to true to use TLS mode

When using Google Memorystore:

  1. Enable only one Redis solution (redis.enabled or redis.memorystore.enabled)
  2. Ensure your GKE cluster has access to the Memorystore instance
  3. Configure the same region as your GKE cluster

Validation

# Get the Memorystore instance connection details
REDIS_HOST=$(gcloud redis instances describe [INSTANCE_ID] \
    --region=[REGION] --format='get(host)')
REDIS_PORT=$(gcloud redis instances describe [INSTANCE_ID] \
    --region=[REGION] --format='get(port)')

# Test connection using redis-cli
redis-cli -h $REDIS_HOST -p $REDIS_PORT ping

Troubleshooting

Connection Failures

  • Verify credentials
  • Check network/firewall rules
  • Confirm TLS settings
  • Validate endpoint format
  • For Memorystore: verify VPC peering

Performance Issues

  • Monitor memory usage
  • Check eviction policies
  • Review connection limits
  • Verify resource allocation
  • For Memorystore: check instance tier

Need help? Contact [email protected] if you encounter any issues.

Postgresql database

Setup and configure PostgreSQL database for your self-hosted platform

Storage

Setup and configure S3-compatible storage for your self-hosted platform

On this page