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

1. Frontend - Vue.js/Quasar web application

   • Modern responsive UI
   • Pre-built Docker image: ghcr.io/gtplusnet/ante-self-hosted-frontend-main:latest

2. Backend - NestJS API server

   • RESTful API + WebSocket support
   • Pre-built Docker image: ghcr.io/gtplusnet/ante-self-hosted-backend:latest

3. PostgreSQL - Primary database

   • Stores core business data
   • Official image: postgres:15

4. Redis - Caching and sessions

   • Session management
   • Queue processing
   • Official image: redis:7-alpine

5. MongoDB - Document storage

   • File metadata
   • Logs and analytics
   • Official image: mongo:7

Installation

The ANTE CLI is the only supported installation method for self-hosting ANTE ERP.

The CLI is a comprehensive command-line tool that handles installation, configuration, maintenance, and troubleshooting automatically.

Why CLI-Only?

• ⚡ Fast Installation - Get running in under 5 minutes
• 🔐 Secure by Default - Automatic credential generation
• ✅ Validated Setup - Pre-installation system checks
• 🎮 Simple Management - Intuitive commands for all operations
• 📦 Safe Updates - Automatic backup before updates
• 🔍 Built-in Diagnostics - ante doctor for troubleshooting
• 💾 Easy Backup/Restore - Simple data protection
• 🗄️ Database Tools - Migrations, optimization, shell access

Quick Start

# Install the CLI globally
npm install -g ante-erp-cli

# Install ANTE ERP (interactive wizard)
ante install

# Check status
ante status

That's it! Your ANTE ERP instance is now running at http://localhost:8080.

Installation Guides

• Quick Install Guide - Get started in 5 minutes
• CLI Installation Guide - Detailed CLI setup instructions
• CLI Command Reference - Complete command documentation

Advanced Configuration

After installation, you can customize your deployment:

• Configuration Reference - Advanced settings
• Database Setup - External database configuration
• SSL & Security - HTTPS and security hardening

Need Direct Docker Control?

If you require direct Docker Compose control (not recommended for most users):

• The CLI uses Docker Compose under the hood
• Installation files are in ./ante-erp/ directory
• See the Docker Scripts README for advanced usage

Note: Manual Docker management is discouraged as it bypasses CLI safety features like automatic backups, health checks, and validation.

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

1. Verify Prerequisites - Check system requirements
2. Download Configuration - Get docker-compose.yml
3. Configure Environment - Set passwords and settings
4. Start Services - Launch all containers
5. Initialize Database - Run migrations
6. Access System - Log in and configure

Quick Links

CLI Documentation

• CLI Overview - Introduction to the ANTE CLI
• CLI Installation - Install the CLI tool
• CLI Command Reference - Complete command documentation
• CLI Troubleshooting - CLI-specific issues

Self-Hosting Guides

• Prerequisites & Requirements
• Quick Installation Guide
• Detailed Installation
• Configuration Reference
• Database Setup
• SSL & Security
• Maintenance & Updates
• Troubleshooting
• Command Reference

Support

If you encounter issues:

1. Check the Troubleshooting Guide
2. Review Common Issues
3. Contact support at support@ante.ph
4. 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