Skip to content
Get packs

Guide · Open source

How to use Aureus ERP (aureuserp): install, run and extend

Updated · written with AI from the project's own documentation and checked against our catalogue data

Aureus ERP (aureuserp) is a self-hosted enterprise resource planning system, software that runs a business's core operations such as accounting, inventory, purchasing, sales and HR. This guide walks you through checking the requirements, cloning and installing the project, and choosing which plugins to enable. It is written for someone comfortable with a command line and a PHP server.

Aureus ERPaureuserp/aureuserp · ★ 12.2k · MIT

Quick start

  1. 1Check requirements. Confirm PHP 8.3+, Composer, Node.js 18.x+ and a supported database (MySQL 8.0+, MariaDB 10.6+ or PostgreSQL 16+) are available.
  2. 2Clone the repo. Run git clone https://github.com/aureuserp/aureuserp.git and then cd into the aureuserp folder.
  3. 3Install PHP dependencies. Run composer install inside the project folder.
  4. 4Run the installer. Run php artisan erp:install to migrate the database, seed data, set up roles and create an admin account.
  5. 5Start the server. Run php artisan serve and open http://localhost:8000 in your browser.
  6. 6Pick your plugins. Enable only the modules you need, such as Accounting, Invoices, Inventories or Products.

Check the requirements before you install

Aureus ERP is built with Laravel and FilamentPHP, so you need a PHP server environment. The README lists PHP 8.3 or higher as a hard requirement, along with a supported database.

  • PHP 8.3 or higher
  • Composer
  • Node.js 18.x or higher
  • One database: MySQL 8.0+, MariaDB 10.6+, or PostgreSQL 16+
  • Web server: Apache 2.4+ or Nginx 1.18+ (listed in the README)

Clone the repository and install dependencies

Download the source code from GitHub, move into the project folder, and install the PHP dependencies with Composer.

git clone https://github.com/aureuserp/aureuserp.git cd aureuserp composer install

Run the installer

The README says the installation command runs database migrations, core seeders, roles and permissions (via Filament Shield), creates an admin account and sets up the environment configuration.

  • Database migrations are executed
  • Core seeders populate initial data
  • Roles and permissions are generated via Filament Shield
  • An admin account is created
  • Environment configuration is set up
php artisan erp:install

Start the server and log in

The README's quick start uses Laravel's built-in development server. Open the address it prints and log in with the admin account created during installation. The README gives http://localhost:8000 as the example address.

php artisan serve

Choose which plugins to install

Aureus ERP is split into plugins. Core system plugins are installed by default, including Analytics, Chatter, Fields, Security, Support and Table View. Other modules are optional and can be installed as needed, grouped in the README under Financial Management (Accounting, Accounts, Invoices, Payments) and Operations (Inventories, Manufacturing, Products, and others).

The README's plugin installation and management section covers how to add and manage these modules; check that section of the repository for the exact steps.

  • Install only the modules your business uses to keep the system lean
  • Invoicing or inventory can be added on their own if those are your only needs

Customize it as a developer

Because the system is built on Laravel and FilamentPHP, PHP developers can extend it with their own plugins and modifications. The README's Customization and Plugin sections describe this path.

  • Read the source code before changing core behaviour
  • Use the plugin system rather than editing core modules where possible

What people use it for

  • Running a small or medium business's accounting and invoicing on your own server
  • Managing inventory and products for a business that needs only those modules
  • Building custom ERP plugins or changes on Laravel and FilamentPHP
  • Avoiding vendor lock-in by hosting and reading the source code yourself

Frequently asked questions

Is aureuserp free?

The project is open source under the MIT licence, which the README states. You can use, modify and extend it. The README separately offers a paid managed hosting option called AureusERP Cloud Hosting.

What are the requirements for aureuserp?

The README requires PHP 8.3 or higher, Composer, Node.js 18.x or higher, and one of MySQL 8.0+, MariaDB 10.6+ or PostgreSQL 16+. Apache 2.4+ or Nginx 1.18+ are listed as web servers.

What command installs aureuserp?

After cloning and running composer install, the README uses php artisan erp:install to run the installation. It handles migrations, seeders, roles and the admin account.

Can I install only some modules?

Yes. The system is plugin-based, and the README says you can install only the features you need, such as accounting or project management.

Is aureuserp suitable for non-technical users?

The README describes self-hosting as the default route and points non-technical owners to its paid managed hosting option. Installing from source requires comfort with a command line and a PHP server.

How does aureuserp compare to Odoo or ERPNext?

Odoo, ERPNext, Dolibarr and Akaunting are comparable projects. Aureus ERP is distinguished by its Laravel and FilamentPHP base and its plugin structure. This guide does not benchmark them, so compare features and requirements for your own needs.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

Aureus ERP suits small and medium businesses with PHP hosting skills, and PHP developers who want an extensible ERP on Laravel and FilamentPHP. It is a poor fit for non-technical owners who want something ready to use, or for teams that need a formal support contract, since the README describes only community and hosting offerings.

Install options & downloads