Self-Hosting Guide - Deploy Relvy in your own cloud infrastructure with full control over data, security, and compliance requirements.

​
Self-Hosting Architecture

Relvy can be self-hosted in your own cloud infrastructure. This guide uses AWS as an example, but the core components are universal. The essential self-hosting setup consists of an application server and database, with optional components for enhanced functionality.

​
Core Components

  • EC2 Application Server Hosts the Relvy application using Docker containers on a t3.xlarge instance with 4 vCPU and 16 GB RAM.
  • RDS PostgreSQL Database Stores application data, user information, and investigation artifacts with encrypted storage and automated backups.

​
Optional Components

If you have a way to route a subdomain to your Relvy application, you can skip the load balancer setup. Otherwise, this guide covers the steps to deploy an Application Load Balancer and obtain an SSL certificate for secure access.
  • Application Load Balancer (ALB) Handles incoming traffic, SSL termination, and distributes requests to the application server with health checks and automatic scaling.
  • SSL Certificate Provides secure HTTPS communication and domain validation through AWS Certificate Manager with automatic renewal.
  • Slack App (Optional) Enables incident response workflows through slash commands, event subscriptions, and interactive messages in Slack channels.

​
Self-Hosting Phases

The self-hosting process is organized into logical phases to ensure a smooth and successful setup:
1
AWS Infrastructure Setup
Create security groups, load balancer, SSL certificate, EC2 instance, and RDS database
2
Domain Configuration
Configure DNS records for SSL validation and domain routing to the load balancer
3
Slack Integration (Optional)
Create Slack app with proper manifest and configure OAuth endpoints
4
Self-Hosting Setup
Install Docker, configure environment, and deploy Relvy using docker-compose
5
Initial Setup - Authentication & SSO
Set up user authentication, SSO integration, and create initial user accounts
6
Configure Relvy - Data Sources & Runbooks
Connect observability data sources, create runbooks, and configure investigation workflows
7
Start Investigation
Begin using Relvy for incident response and automated investigation workflows

​
System Requirements

​
AWS Resources

ComponentSpecificationPurpose
EC2 Instancet3.xlarge (4 vCPU, 16 GB RAM)Self-hosted application
RDS Databasedb.t3.medium (2 vCPU, 4 GB RAM)PostgreSQL database
Storage100 GB (EC2) + 50 GB (RDS)Application and data storage
Load BalancerApplication Load BalancerTraffic distribution and SSL termination

​
Software Requirements

  • Docker: Container runtime for self-hosted deployment
  • Docker Compose: Multi-container orchestration
  • PostgreSQL Client: For database connectivity testing
  • SSH Access: For EC2 instance management

​
Network Requirements

  • Public Domain: A domain name for SSL certificate and application access
  • DNS Management: Access to configure DNS records
  • Internet Connectivity: For package downloads and Docker image pulls

​
Security Groups

The self-hosting setup uses three security groups to control network access:
Security GroupPurposeInbound RulesOutbound Rules
ALB Security GroupLoad balancer accessHTTP (80), HTTPS (443) from internetHTTP (80) to app instances
App Security GroupApplication server accessHTTP (80) from ALB, SSH (22) from your IPHTTPS (443), HTTP (80), DNS (53), PostgreSQL (5432) to DB
Database Security GroupDatabase accessPostgreSQL (5432) from app instancesNone

​
Next Steps

Before proceeding with the self-hosting setup, ensure you have:
  1. ✅ Domain Management Access - Control over your domain’s DNS settings
  2. ✅ AWS Account - Access to create and manage AWS resources
  3. ✅ Docker Knowledge - Basic understanding of containers and docker-compose
  4. ✅ Repository Access - Ability to clone the Relvy repository
Ready to get started? Proceed to Prerequisites to review all requirements in detail.