Skip to main content

​
What are Odoo Instances?

An Odoo instance is a complete, isolated Odoo installation running on a deployERP server. Each instance includes:
  • Dedicated Odoo application
  • Separate PostgreSQL database
  • Independent filestore
  • Custom configuration
  • Unique domain/subdomain
You can run multiple instances on a single server for cost efficiency or dedicate servers to critical instances for maximum performance.

​
Instance Architecture

​
Instance Types

​
Production Instances

For live business operations:
  • Multi-worker configuration
  • Performance optimization
  • Automated backups
  • High availability
  • SSL encryption

​
Staging Instances

For testing and validation:
  • Production-like environment
  • Separate database
  • Testing modules
  • Performance profiling
  • Update validation

​
Development Instances

For building and customization:
  • Debug mode available
  • Developer tools
  • Code reloading
  • Lower resources
  • Flexible configuration

​
Supported Versions

deployERP supports all active Odoo versions:
VersionEditionPythonPostgreSQLStatus
Odoo 17.0CE/EE3.10+12+Active
Odoo 16.0CE/EE3.10+12+Active
Odoo 15.0CE/EE3.8+12+Active
Odoo 14.0CE/EE3.6+10+Maintenance
CE = Community Edition (Free) EE = Enterprise Edition (Requires license)

​
Instance Features

​
Core Capabilities

Custom Domains

Use your own domain with automatic SSL

Database Management

Full database access and management

Module Installation

Install custom and third-party modules

Configuration Control

Fine-tune Odoo settings and parameters

​
Advanced Features

  • Multi-database: Run multiple databases per instance
  • Load balancing: Distribute traffic across workers
  • Caching: Redis integration for performance
  • CDN Support: Static asset delivery
  • Email Integration: SMTP configuration
  • Scheduled Actions: Cron job management

​
Instance Configuration

​
Essential Settings

# Instance configuration example
{
    "name": "production-erp",
    "version": "17.0",
    "edition": "enterprise",
    "domain": "erp.company.com",
    "database": "production_db",
    "admin_email": "[email protected]",
    "workers": 4,
    "limit_memory_hard": 2684354560,
    "limit_memory_soft": 2147483648,
    "max_cron_threads": 2
}

​
Performance Parameters

ParameterDescriptionDefaultRange
workersNumber of HTTP workers21-32
max_cron_threadsScheduled job threads21-8
limit_memory_hardHard memory limit (bytes)2.5GB1-64GB
limit_memory_softSoft memory limit (bytes)2GB1-64GB
limit_time_cpuCPU time limit (seconds)6010-600
limit_time_realReal time limit (seconds)12020-1200

​
Instance Management

​
Creating Instances

1

Select Server

Choose target server with adequate resources
2

Configure Version

Select Odoo version and edition
3

Set Parameters

Define database name, admin credentials
4

Deploy

Automated installation and configuration
5

Access

Receive URL and login credentials

​
Instance Operations

Available actions for running instances:
  • Start/Stop: Control instance state
  • Restart: Apply configuration changes
  • Update: Upgrade Odoo version
  • Clone: Duplicate for testing
  • Backup: Create manual snapshot
  • Delete: Remove instance and data

​
Database Management

​
Database Operations

  • Create new databases
  • Duplicate existing databases
  • Restore from backup
  • Export/Import data
  • SQL query execution
  • Index optimization

​
Database Access

Connect directly to PostgreSQL: 
psql -h server.deployerp.io -p 5432 -U odoo -d production_db
Direct database access should be used carefully. Always backup before making changes.

​
Module Management

​
Installing Modules

  1. From Odoo Apps Store
    • Browse and install directly
    • Automatic dependency resolution
    • Version compatibility check
  2. Custom Modules
    • Upload via Git integration
    • FTP/SFTP upload
    • Direct file transfer
  3. Third-party Modules
    • OCA modules support
    • Community contributions
    • Custom repositories

​
Module Updates

# Update module list
./odoo-bin -u all -d production_db

# Update specific module
./odoo-bin -u sale,purchase -d production_db

​
Instance Monitoring

​
Health Metrics

Monitor in real-time:
  • Request rate
  • Response time
  • Error rate
  • Active users
  • Database size
  • Memory usage

​
Performance Insights

  • Slow query analysis
  • Request profiling
  • Memory leak detection
  • Cache hit rates
  • Worker utilization

​
Backup & Recovery

​
Automated Backups

Configure automatic backups:
  • Frequency: Hourly, Daily, Weekly
  • Retention: 7-365 days
  • Storage: S3, Spaces, Custom
  • Encryption: AES-256

​
Recovery Options

  • Point-in-time: Restore to specific moment
  • Full restore: Complete instance recovery
  • Selective restore: Database or filestore only
  • Cross-region: Restore to different location

​
Security

​
Instance Security Features

  • SSL/TLS: Automatic HTTPS encryption
  • Firewall: IP whitelisting available
  • Access Control: User permission management
  • Audit Logs: Track all activities
  • 2FA: Two-factor authentication
  • Session Management: Timeout and controls

​
Compliance

  • GDPR compliance tools
  • Data residency options
  • Audit trail maintenance
  • Data encryption at rest
  • Regular security updates

​
Troubleshooting

​
Common Issues

IssueSymptomsSolution
Instance not starting500 errorCheck logs, verify configuration
Slow performanceLong load timesIncrease workers, optimize queries
Module errorsInstallation failsCheck dependencies, compatibility
Database lockedConnection refusedRestart instance, check connections

​
Log Access

View logs for debugging: 
# Odoo logs
tail -f /var/log/odoo/odoo.log

# PostgreSQL logs
tail -f /var/log/postgresql/postgresql.log

# Nginx logs
tail -f /var/log/nginx/access.log

​
Best Practices

Regular Updates

Keep Odoo and modules updated

Test First

Use staging for testing changes

Monitor Performance

Track metrics and optimize regularly

Backup Strategy

Implement comprehensive backup plan