Self-Hosting ANTE ERP
Welcome to the self-hosted ANTE ERP installation guide! This comprehensive documentation will help you deploy and manage your own instance of ANTE ERP on your infrastructure.
What is Self-Hosting?
Self-hosting means running ANTE ERP on your own servers or infrastructure, giving you complete control over your data, security, and deployment environment. Unlike cloud-hosted solutions, self-hosting allows you to:
- Full Data Control: Your business data stays on your infrastructure
- Customization: Configure the system to meet your specific needs
- Compliance: Meet regulatory requirements for data residency
- Cost Control: Predictable infrastructure costs without per-user fees
- Network Control: Run on internal networks without internet exposure
Why Self-Host ANTE ERP?
For Small to Medium Businesses
- Deploy on existing infrastructure
- No recurring subscription fees
- Suitable for 5-100 users
- Full feature access
For Enterprises
- Complete data sovereignty
- Integration with existing systems
- Custom security policies
- Dedicated resources
For Development Teams
- Test environment setup
- Development and staging instances
- Custom module development
- API integration testing
System Architecture
ANTE ERP uses a modern containerized architecture:
┌─────────────────────────────────────────────────────────┐
│ Nginx (Optional) │
│ Reverse Proxy + SSL/HTTPS │
└─────────────────────────────────────────────────────────┘
│
┌───────────────────┴────────────────────┐
│ │
┌───────▼─────────┐ ┌─────────▼────────┐
│ Frontend │ │ Backend │
│ (Vue/Quasar) │ │ (NestJS) │
│ Port: 8080 │◄─────API──────────│ Port: 3001 │
└─────────────────┘ └──────────────────┘
│
┌──────────────────────┼──────────────────────┐
│ │ │
┌───────▼────────┐ ┌───────▼───────┐ ┌────────▼────────┐
│ PostgreSQL │ │ Redis │ │ MongoDB │
│ Port: 5433 │ │ Port: 6380 │ │ Port: 27018 │
│ (Main Database)│ │ (Cache) │ │ (Documents) │
└────────────────┘ └───────────────┘ └─────────────────┘Components
Frontend - Vue.js/Quasar web application
- Modern responsive UI
- Pre-built Docker image:
ghcr.io/gtplusnet/ante-self-hosted-frontend-main:latest
Backend - NestJS API server
- RESTful API + WebSocket support
- Pre-built Docker image:
ghcr.io/gtplusnet/ante-self-hosted-backend:latest
PostgreSQL - Primary database
- Stores core business data
- Official image:
postgres:15
Redis - Caching and sessions
- Session management
- Queue processing
- Official image:
redis:7-alpine
MongoDB - Document storage
- File metadata
- Logs and analytics
- Official image:
mongo:7
Installation Methods
Choose the installation method that best suits your needs:
Option 1: CLI Installation (Recommended) ⭐
The fastest and easiest way to install ANTE ERP. One command does everything automatically.
Time: ~5 minutes Complexity: Very Low Best for: All users, production deployments, quick evaluation
Features:
- ⚡ Fully automated installation
- 🔐 Automatic secure credential generation
- ✅ Built-in system validation
- 🎮 Integrated management commands
- 📦 One-command updates
- 🔍 Health diagnostics included
npm install -g ante-erp-cli
ante install→ Quick Install Guide with CLI
Option 2: Docker Installation (Manual)
For users who prefer direct control over Docker configuration.
Time: ~20 minutes Complexity: Low Best for: Users comfortable with Docker, custom configurations
Option 3: Detailed Installation
Comprehensive step-by-step guide with full explanations and customization options.
Time: ~45 minutes
Complexity: Medium
Best for: First-time installers, custom configurations
Option 3: Advanced Setup
Complete control with advanced features like clustering, external databases, and custom builds.
Time: 2-4 hours
Complexity: High
Best for: Enterprise deployments, development teams
→ Advanced Configuration Guide
Pre-Built Docker Images
ANTE ERP provides publicly available Docker images hosted on GitHub Container Registry (GHCR):
Backend Image
ghcr.io/gtplusnet/ante-self-hosted-backend:latest- Based on Node.js Alpine
- Production-optimized build
- Includes all dependencies
- No authentication required (public image)
Frontend Image
ghcr.io/gtplusnet/ante-self-hosted-frontend-main:latest- Nginx-based static server
- Pre-built Vue/Quasar application
- Optimized for production
- No authentication required (public image)
Benefits of Pre-Built Images
- Fast deployment: No build time required
- Tested builds: Each image is tested before release
- Version control: Tag-based versioning for stability
- Auto-updates: Pull latest images for updates
- No build tools needed: No Node.js or build environment required
Installation Process Overview
- Verify Prerequisites - Check system requirements
- Download Configuration - Get docker-compose.yml
- Configure Environment - Set passwords and settings
- Start Services - Launch all containers
- Initialize Database - Run migrations
- Access System - Log in and configure
Quick Links
- Prerequisites & Requirements
- Quick Installation Guide
- Configuration Reference
- Database Setup
- SSL & Security
- Maintenance & Updates
- Troubleshooting
- Command Reference
Support
If you encounter issues:
- Check the Troubleshooting Guide
- Review Common Issues
- Contact support at support@ante.ph
- Report bugs on GitHub Issues
Next Steps
Ready to get started?
👉 Check Prerequisites - Verify your system meets requirements
👉 Quick Install - Get started in 20 minutes
👉 Detailed Guide - Step-by-step instructions
Last Updated: October 27, 2025