webkul/aureuserp repository overview

⁠Aureus ERP – Open-Source ERP Solution

⁠What is Aureus ERP?

Aureus ERP is a powerful, open-source Enterprise Resource Planning (ERP) system designed to streamline business operations for small and medium enterprises (SMEs) and large-scale enterprises. Built on Laravel 11.x and FilamentPHP 3.x, it offers a modular, scalable, and developer-friendly solution to manage core business functions such as finance, HR, inventory, and customer relations.

⁠Why Use Aureus ERP?

• Modern Technology Stack: Built with Laravel for security and scalability.
• FilamentPHP Integration: Provides an intuitive and dynamic admin panel.
• Highly Modular: Easily extendable with custom modules.
• Open-Source & Free: Licensed under MIT, allowing full customization.
• User-Friendly Interface: Optimized with TailwindCSS for a seamless experience.
• Enterprise-Ready: Scales with business growth and complex workflows.

⁠How to Deploy Aureus ERP with Docker

⁠Prerequisites

Before proceeding, ensure that you have the latest version of Docker installed along with its dependencies. Refer to the official Docker installation guide⁠ for detailed instructions.

The Aureus ERP Docker image includes:

• PHP 8.2+ with required extensions
• MySQL 8.0+ for database management
• Apache pre-configured for optimal performance
• Composer & Node.js for dependency and asset management

Additionally, ensure that:

• No other services are using ports 80 (Apache) or 3306 (MySQL). Modify ports if needed.
• Your user has the necessary privileges to run Docker commands.

⁠Step 1: Pull the Docker Image

Begin by pulling the Aureus ERP Docker image with the following command:

docker pull webkul/aureuserp:latest

⁠Step 2: Run the Container

After pulling the image, start the container with the following command:

docker run -itd -p 80:80 -p 3306:3306 --name aureuserp webkul/aureuserp:latest

⁠Explanation of the Command:

• -itd: Runs the container in detached mode.
• -p 80:80: Maps port 80 on the host to port 80 in the container (for web access).
• -p 3306:3306: Maps port 3306 on the host to port 3306 in the container (for MySQL).
• --name aureuserp: Names the container "aureuserp" for easy reference.
• webkul/aureuserp:latest: Specifies the latest Aureus ERP Docker image.

⁠Step 3: Verify the Running Container

To check if your container is running, use the command:

docker ps

You should see "aureuserp" in the list of active containers.

⁠Step 4: Access Aureus ERP

Open your browser and navigate to:

http://localhost  

Or use your server's IP address to access the application.

⁠Step 5: Complete Installation & Login

Once the setup process is finished, go to your browser and log in using the following credentials:

⁠Admin Panel Login:

• URL: http://localhost/
• Email: [email protected]
• Password: admin@123

⁠Step 6: Access the Database (Optional)

To connect to MySQL inside the container, use:

docker exec -it aureuserp mysql -u root -p

If you need to stop the container, run:

docker stop aureuserp

To restart it, use:

docker start aureuserp

⁠Getting Support

If you encounter any issues or have questions, please contact us at [email protected]⁠ or raise a ticket at Aureus ERP Support.

Your Aureus ERP container is now up and running! 🚀