The Open Source, 100% JavaScript and "all in one" ecommerce solution.

AquilaCMS is :

• An open-source e-commerce web application
• A 100% JavaScript solution with MERN Stack
• A mutli-themes website : Front-end can be used with ReactJS and NextJS (for polymorphism) or any other JS technology (VueJS, Angular, etc)
• A complete back office to manage everything in your website
• A plateform to add modules and themes from Aquila's Shop

To install the latest AquilaCMS, you need :

• node.js 14+ (tested in v14.17.1)
• mongoDB 4.2.5+
• yarn 1.22.4+ package manager

• You must verify that you have these packages installed on your OS :

g++ gcc libgcc libstdc++ linux-headers make python libtool automake autoconf nasm wkhtmltopdf vips vips-dev libjpeg-turbo libjpeg-turbo-dev

• You will probably have to download:

  • wkhtmltopdf : https://wkhtmltopdf.org/downloads.html (it needs to be in the PATH)
  • libvips : https://github.com/libvips/libvips/releases (beware of 32 or 64 bits versions and it also needs to be in the PATH)

You can download the source code from GitHub and run the following command-line (not 'Windows cmd') to launch the installer.

• With npm :

yarn install
npm start

• With pm2 :

yarn install
cp ecosystem.config.example.js ecosystem.config.js
npm run start:pm2

• With docker :

# create a network to link mongo and Aquila CMS
docker network create aquila
# create the mongo instance
docker run --name mongo -p 27017:27017 --network=aquila mongo
# pull the latest and run AquilaCMS
docker run -p 127.0.0.1:3010:3010/tcp --network=aquila --name aquila aquilacms/aquilacms

• You can just launch the AquilaCMS image without creating a network if you don't want to connect to a MongoDB launched via Docker
• if you change the port of the docker container, remember to use the correct PORT env variable.

At the first launch, there is an installation page. It allows you to create an env.json file in the config folder.

You can edit this file manually, an example of the different possible properties is in the config/env.example.json file. You can also found all the properties in the documentation

⚠️Warning : there is not MongoDB in AquilaCMS image

To connect your AquilaCMS website to a Mongo database, you can :

• run a MongoDB image next to the AquilaCMS image like in the example above (and use this mongodb container as hostname : mongodb://mongo:27017/)
• use an external link to, for example, an Atlas database
• use a localhost link to connect AquilaCMS to a database on your host machine (you have to edit your mongod.conf and change your bindIp by your network ip instead of 127.0.0.1)

If you want to have the installation page again, you can remove the env.json file in the config/ folder.

You can define two environment variables inside AquilaCMS.

• NODE_ENV : you should only limit values to production, development or test (See 'Non standard node env')
• AQUILA_ENV : define the environment values in /config/env.json to be loaded

If you want, for any reason, to manually build a theme, you can execute this command at the root of AquilaCMS :

npm run build:win --theme=default_theme

• Instead of build:win you can use build:linux
• At the variable --theme you need to put the name of the theme folder you want to build.

⚠️Warning : on Windows, you must use Powershell Otherwise, you may get an error when using the npm run build:win command.

Find some documentation on :

• https://doc.aquila-cms.com/
• https://aquila-cms.com/api-docs, the swagger documentation
• On a local Aquila at /api-docs

You can also check some tutorials on :

• Our dedicated page
• Our youtube channel

If you want to contribute, you will need to install husky or else you won't be able to commit new feature

yarn husky:install

Demos website are available:

You can check the default front here :

• https://dem01.aquila-cms.com/
• https://dem02.aquila-cms.com/

You can check the backoffice here :

• https://dem01.aquila-cms.com/demadmin
• https://dem02.aquila-cms.com/demadmin

Logins are :

AquilaCMS is licensed under OSL3