How to Setup Aureus ERP on AWS Server

Anuj Mishra

6 March 2025

Introduction

Aureus ERP is an open-source Enterprise Resource Planning (ERP) solution designed to streamline business operations.

It supports both SMEs and large enterprises, providing a scalable and customizable platform for finance, inventory, sales, HR, and customer management.

In this guide, you’ll learn how to set up Aureus ERP on AWS step by step.”

Why Choose Aureus ERP?

ERP systems unify multiple business processes into a single platform.

Deploying Aureus ERP on AWS provides a scalable, cloud-based solution for managing finance, inventory, sales, HR, and customer relationships.

With AWS, you benefit from high availability, security, and seamless scaling, reducing manual workload and improving efficiency.

Key Features

Built with Laravel – Ensures security, reliability, and scalability, making it a robust framework for enterprise applications.
Powered by FilamentPHP – Provides an intuitive and efficient interface for resource management, making administration seamless.
Highly Modular Design – Allows for easy customization and integration of additional modules tailored to specific business needs.
Open-Source Solution – Free to use, modify, and extend, making it a cost-effective option for businesses of all sizes.
Scalable for Enterprises – Designed to handle complex business operations and scale effortlessly as your organization grows.

Prerequisites

Before you start setting up Aureus ERP on AWS, ensure your server meets these requirements:

An AWS EC2 instance (Ubuntu 24.04 recommended).
Apache/Nginx server
PHP 8.2 or higher with required PHP extensions
MySQL 8.0+.
Composer 2.5.3 or higher.

We selected t2.small (1 vCPUs, 2GB RAM) ec2 instance.

Let’s begin the step-by-step process for setting up Aureus ERP on AWS.

Step 1: Connect to Your AWS Server via SSH

To connect to your AWS EC2 instance securely, use the SSH key pair you selected during setup:

1	ssh -i your-key.pem ubuntu@your-server-ip

Step 2: Update System Packages

Update system packages before installing dependencies:

1	sudo apt-get update

Step 3: Installing Apache

Install Apache:

sudo apt-get install apache2 -y

sudo systemctl enable apache2

sudo systemctl start apache2

Restart Apache:

1	sudo systemctl status apache2

Step 4: Installing PHP and Required Extensions

Install PHP 8.2 and required extensions:

sudo apt install software-properties-common

sudo add-apt-repository ppa:ondrej/php

sudo apt-get update

sudo apt-get install -y php8.2-cli php8.2-apcu php8.2-bcmath php8.2-curl php8.2-opcache php8.2-fpm php8.2-gd php8.2-intl php8.2-mysql php8.2-xml php8.2-zip php8.2-mbstring php8.2-imagick libapache2-mod-php8.2

Step 5: Installing Composer

Composer is required to manage PHP dependencies. Install it with:

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"

php -r "if (hash_file('sha384', 'composer-setup.php') === 'dac665fdc30fdd8ec78b38b9800061b4150413ff2e3b6f88543c636f7cd84f6db9189d43a81e5503cda447da73c7e5b6') { echo 'Installer verified'.PHP_EOL; } else { echo 'Installer corrupt'.PHP_EOL; unlink('composer-setup.php'); exit(1); }"

php composer-setup.php

https://webkul.uvdesk.com/en/member/ticket/view/590911

php -r "unlink('composer-setup.php');"

sudo mv composer.phar /usr/local/bin/composer

Step 6: Installing MySQL and Creating a Database

Install MySQL:

1	sudo apt install mysql-server -y

Create a database and user for Aureus ERP:

mysql -u root -p

CREATE DATABASE aureuserp_db;

CREATE USER 'aureuserp'@'localhost' IDENTIFIED BY 'yourpassword';

GRANT ALL PRIVILEGES ON aureuserp_db.* TO 'aureuserp'@'localhost';

FLUSH PRIVILEGES;

EXIT;

For AWS RDS (if using a remote database):

Now connect to RDS and configure the database:

mysql -u admin -p -h [RDS_endpoint]

#Create the database and user for aureuserp:

CREATE USER 'aureuserp'@'localhost' IDENTIFIED BY 'yourpassword';

CREATE DATABASE aureuserp_db;

GRANT ALL PRIVILEGES ON aureuserp_db.* TO 'aureuserp'@'localhost';

FLUSH PRIVILEGES;

exit

Step 7: Creating a New User

For better security, create a new user.

1	sudo adduser aureuserp

Step 8: Cloning Aureus ERP from GitHub

Navigate to the home directory and clone the repository:

cd /home/aureuserp

git clone https://github.com/aureuserp/aureuserp.git

Navigate to the project folder:

1	cd aureuserp

Step 9: Configuring Environment Variables

Copy the example environment file:

1	cp .env.example .env

Edit the .env file:

nano .env

Update database settings:

APP_NAME=Aureuserp

APP_DEBUG=false

APP_URL=http://localhost/

DB_CONNECTION=mysql

DB_HOST=localhost

DB_PORT=3306

DB_DATABASE=aureuserp_db

DB_USERNAME=aureuserp

DB_PASSWORD=yourpassword

Save and exit.

Step 10: Configuring Apache for Aureus ERP

Edit Apache configuration:

1	sudo nano /etc/apache2/sites-available/aureuserp.local.conf

Add the following configuration:

ServerAdmin webmaster@localhost

DocumentRoot /home/aureuserp/aureuserp/public

ServerName aureuserp.local

ErrorLog ${APACHE_LOG_DIR}/error.log

CustomLog ${APACHE_LOG_DIR}/access.log combined

AllowOverride All

Require all granted

</Directory>

</VirtualHost>

Make changes in the Apache envvars file as per your user

1	nano /etc/apache2/envvars

Enable the site:

sudo a2dissite 000-default.conf

sudo a2enmod rewrite

sudo a2ensite aureuserp.local.conf

Restart Apache:

1	sudo systemctl restart apache2

Step 11: Installing Dependencies with Composer

Inside the project directory, install PHP dependencies:

1	composer install

Set correct ownership:

1	chown -R aureuserp:aureuserp /home/aureuserp

Step 12: Generating Application Key

Run the following command to generate the application key:

1	php artisan key:generate

Step 13: Running Aureus ERP Installation

Run the installation command:

1	php artisan erp:install

Set your admin Name, email, and password, and finish the installation.

For Example:

My admin credentials are:

ADMINISTRATOR_NAME=admin

ADMINISTRATOR_EMAIL=your_admin@example.com

ADMINISTRATOR_PASSWORD=admin@123

Step 14: Access Aureuserp

Your Aureus ERP installation is now complete! To access the dashboard, open your browser and visit:

http://localhost/

Aureus ERP provides various sections for efficient business management. Some key features include:

1. Companies Management – Allows users to add, manage, and organize company details, branches, and related settings.

2. Roles & Permissions – This enables administrators to define user roles, assign permissions, and control access levels within the system.

Need Support?

Thank You for reading this Blog!

For further more interesting blogs, keep in touch with us. If you need any kind of support, simply raise a ticket at https://webkul.uvdesk.com/en/.

For further help or queries, please contact us or raise a ticket.