Skip to content

System Requirements

This page outlines the technical requirements for self-hosting Recogito Studio.

Server Specifications

Section titled “Server Specifications”

Minimum Requirements

Section titled “Minimum Requirements”
  • Operating System: Ubuntu Linux 20.04+ (Ubuntu 24.04 LTS recommended)
  • CPU: 2 cores minimum
  • Memory: 4GB RAM minimum
  • Storage: 50GB available disk space
  • Network: Reliable internet connection with public IP
Section titled “Recommended for Production”
  • CPU: 4+ cores
  • Memory: 8GB+ RAM
  • Storage: 100GB+ SSD storage
  • Network: High-bandwidth connection
  • Backups: Automated backup strategy

Software Dependencies

Section titled “Software Dependencies”

Required Software

Section titled “Required Software”
  • Docker - Container runtime
  • Docker Compose - Container orchestration
  • Nginx - Web server and reverse proxy
  • Git - Version control (for installation)
  • NPM/Node.js - JavaScript runtime

Optional Software

Section titled “Optional Software”
  • UFW - Uncomplicated Firewall (recommended)
  • Certbot - Let’s Encrypt certificate management

Network Requirements

Section titled “Network Requirements”

Ports

Section titled “Ports”

The following ports need to be accessible:

  • 80 (HTTP) - Web traffic (redirects to HTTPS)
  • 443 (HTTPS) - Secure web traffic
  • 22 (SSH) - Server administration

Domain Names

Section titled “Domain Names”

You’ll need access to configure DNS records for:

  • Main server domain (server.yourdomain.com)
  • Client application (client.yourdomain.com)
  • Administration interfaces:
    • Portainer (portainer.yourdomain.com)
    • pgAdmin (pgadmin.yourdomain.com)
    • MinIO (minio.yourdomain.com)

Optional for plugins:

  • Trigger.dev (trigger.yourdomain.com)

Security Considerations

Section titled “Security Considerations”

Firewall Configuration

Section titled “Firewall Configuration”
  • Close unnecessary ports
  • Allow only required services
  • Use UFW or equivalent firewall management

SSL/TLS Certificates

Section titled “SSL/TLS Certificates”
  • HTTPS required for all services
  • Let’s Encrypt certificates recommended
  • Automatic renewal configured

Authentication

Section titled “Authentication”
  • Strong passwords for all service accounts
  • Secure JWT secrets and API keys
  • Regular password rotation policy

Performance Considerations

Section titled “Performance Considerations”

Database

Section titled “Database”
  • PostgreSQL with proper indexing
  • Regular maintenance and optimization
  • Backup and recovery strategy

File Storage

Section titled “File Storage”
  • MinIO for object storage
  • Adequate disk space for documents
  • Consider S3-compatible external storage

Monitoring

Section titled “Monitoring”
  • System resource monitoring
  • Application performance tracking
  • Log aggregation and analysis

Supported Platforms

Section titled “Supported Platforms”

Tested Environments

Section titled “Tested Environments”
  • Digital Ocean Droplets - Fully tested
  • AWS EC2 - Compatible
  • Google Cloud Platform - Compatible
  • Azure VMs - Compatible
  • On-premises servers - Compatible

Operating Systems

Section titled “Operating Systems”
  • Ubuntu 24.04 LTS - Recommended
  • Ubuntu 22.04 LTS - Supported
  • Ubuntu 20.04 LTS - Supported
  • Other Debian-based - May work with modifications

Container Resources

Section titled “Container Resources”

Docker Requirements

Section titled “Docker Requirements”

The installation includes multiple containers:

  • Supabase stack - Database, API, Auth
  • Client application - Astro.js frontend
  • MinIO - Object storage
  • Portainer - Container management
  • pgAdmin - Database administration

Resource Allocation

Section titled “Resource Allocation”

Each container has specific resource needs:

  • Database containers require consistent CPU and memory
  • Client application needs adequate memory for builds
  • Storage containers need reliable disk I/O

Scaling Considerations

Section titled “Scaling Considerations”

Horizontal Scaling

Section titled “Horizontal Scaling”
  • Load balancer for multiple instances
  • Shared database and storage
  • Session management strategy

Vertical Scaling

Section titled “Vertical Scaling”
  • Increase server resources as needed
  • Monitor performance metrics
  • Plan for growth in users and content

Backup Requirements

Section titled “Backup Requirements”

Critical Data

Section titled “Critical Data”
  • PostgreSQL database backups
  • MinIO object storage backups
  • Configuration files and secrets
  • SSL certificates

Backup Strategy

Section titled “Backup Strategy”
  • Daily automated backups recommended
  • Off-site backup storage
  • Regular restoration testing
  • Document recovery procedures