This repository contains a complete Docker-based ERPNext installation with fresh MariaDB and Redis setup.

• Fresh Installation: Completely new MariaDB database and Redis cache
• Docker-based: Easy deployment and management
• Optimized Configuration: MariaDB tuned for ERPNext performance
• Backup/Restore: Built-in database backup and restore functionality
• Development Mode: Pre-configured for development with auto-reload

If you have existing ERPNext data, restore from a backup first:

1. List available backups:

   make list-backups

2. Restore database from backup:

   make restore-db BACKUP_FILE=backups/erpnext_db_YYYYMMDD_HHMMSS.sql

3. Start ERPNext with static assets:

   make run-with-static

4. Login to ERPNext:

   • Email: [email protected]
   • Password: [your usual password]

5. Access ERPNext modules:

   • Suppliers: http://172.18.0.4:8001/app/supplier
   • Customers: http://172.18.0.4:8001/app/customer
   • Purchase Invoices: http://172.18.0.4:8001/app/purchase-invoice
   • Main Dashboard: http://172.18.0.4:8001/app

Note: If you encounter login issues after restoring, reset your password:

docker exec -it erpnext-app bench --site erpnext.localhost set-password [email protected] your_new_password

For a brand new ERPNext instance:

1. Install ERPNext:

   make install

2. Access ERPNext:

   • URL: http://localhost:8000
   • Username: Administrator
   • Password: admin

Copy config.env to .env and modify as needed:

cp config.env .env

Key configuration options:

• MYSQL_ROOT_PASSWORD: MariaDB root password
• MYSQL_PASSWORD: ERPNext database password
• ADMIN_PASSWORD: ERPNext admin password
• SITE_NAME: ERPNext site name

The MariaDB configuration is optimized for ERPNext in config/mariadb.cnf:

• InnoDB buffer pool: 1GB
• UTF8MB4 character set
• Optimized for ERPNext workloads

• ERPNext: Main application (port 8000)
• MariaDB: Database server (port 3306)
• Redis: Cache and queue server (port 6379)

If you encounter issues, reset everything:

make clean
make install

Reset only the database:

make reset-db
make install

Check service logs:

make logs

Open shell in ERPNext container:

make shell

Comprehensive backup (recommended):

make backup

Database only:

make backup-db

make list-backups

1. List available backups:

   make list-backups

2. Restore specific backup:

   make restore-db BACKUP_FILE=backups/erpnext_db_20250920_175433.sql

3. Reset passwords after restore (if needed):

   # Reset Administrator password
   docker exec -it erpnext-app bench --site erpnext.localhost set-admin-password newpassword123
   
   # Reset specific user password
   docker exec -it erpnext-app bench --site erpnext.localhost set-password [email protected] newpassword123

Important: Restoring a database will overwrite all current data and reset all user passwords to what they were at the time of the backup.

The installation is configured for development with:

• Developer mode enabled
• Auto-update disabled
• Debug logging enabled

For production deployment:

1. Change default passwords in .env
2. Use proper SSL certificates
3. Configure proper backup schedules
4. Set up monitoring
5. Use external database and Redis if needed

For ERPNext documentation, visit: https://docs.erpnext.com/