Skip to content

grandnode/grandnode2

Repository files navigation

GrandNode - Open Source E-Commerce Platform

OPEN-SOURCE E-COMMERCE PLATFORM
FREE, FAST, FLEXIBLE, FEATURE-RICH

GrandNode is a powerful, scalable e-Commerce platform built with MongoDB and ASP.NET Core.
Based on the modern MongoDB database, this fully open-source system supports multiple business models:
B2B, B2C, Multi-Store, Multi-Vendor, Multi-Tenant, Multi-Language, Multi-Currency.
Achieve superior performance, unlimited scalability, and comprehensive customization to drive your online business success.

Explore the project Β»

View Demo Β· Report Bug Β· Request Feature Β· Visit forum Β· Themes Β· Integrations & Plugins Β· Premium support

Tests on Linux, MacOS and Windows Build Status Docker Image CI License CodeQL Advanced Quality Gate Status

Table of Contents

Overview

GrandNode was designed to solve the most important business challenges from the world of digital shopping. The goal for us is to provide the platform with:

  • The high performance front-end, rendered within miliseconds,
  • The high performance application to handle temporary and permanent traffic overloads,
  • Highly advanced e-commerce platform with unlimited possibilities of integration with existing third-party softwares
  • Fast development with modern codebase
  • Scalable e-commerce platform to grow with the business

Key Features

Performance & Architecture

  • ⚑ High-Performance - Pages render in milliseconds
  • πŸ“Š MongoDB Database - Superior scalability and performance
  • πŸš€ ASP.NET Core - Modern and efficient codebase

Business Features

  • πŸͺ Multi-Store Management - Run multiple stores from one installation
  • πŸ‘₯ B2B & B2C Support - Serve both business and consumer customers
  • 🌎 Multi-Language & Multi-Currency - Sell globally with localized experiences
  • πŸ›’ Advanced Product Catalog - Flexible product attributes, variants, and pricing
  • πŸ’° Multiple Payment Gateways - Including Stripe, BrainTree and more
  • 🚚 Customizable Shipping Options - Fixed rate, by weight, shipping points
  • πŸ“± Mobile-Optimized - Responsive design for all devices

Marketing & SEO

  • πŸ” SEO-Friendly - URL structure, meta tags, and sitemap generation
  • πŸ”” Customer Segmentation - Target specific customer groups
  • πŸ“§ Email Marketing Integration - Boost your sales with newsletters
  • πŸ“Š Analytics Integration - Track performance with Google Analytics

Technical Highlights

GrandNode 2 leverages the latest technologies to deliver a high-performance e-commerce solution:

  • ASP.NET Core 9.0 - Modern, cross-platform framework
  • MongoDB 4.0+ - NoSQL database for unlimited scalability
  • Docker Support - Easy deployment and containerization
  • REST API - Comprehensive API for integrations
  • Cloud-Ready - Optimized for cloud hosting environments
  • Real-time Processing - Immediate updates throughout the system

Getting Started

To get a local copy up and running follow these simple steps.

Prerequisites (develop version)

GrandNode requires .NET Core 9.0, MongoDB 4.0+, and OS-specific dependency tools.

Installation

GrandNode can be installed in a few different ways. Note: The develop branch is the development version of GrandNode and it may be unstable. The main branch is the primary branch that contains the latest stable version. You can also download specific stable versions from the Releases page or switch to a release branch.

  • Docker
docker run -d -p 127.0.0.1:27017:27017 --name mongodb mongo 
docker run -d -p 80:8080 --name grandnode2 --link mongodb:mongo -v grandnode_images:/app/wwwroot/assets/images -v grandnode_appdata:/app/App_Data grandnode/grandnode2

If you want to download the latest stable version of GrandNode please use the following command, where x.xx is a number of GrandNode release:

docker pull grandnode/grandnode2:x.xx 
  • Open locally with VS2022+ (v17.12.0) or above

Run the project in the Visual Studio 2022+, extract the source code package downloaded from Releases tab to a folder. Enter the extracted folder and double-click the GrandNode.sln solution file. Select the Plugins project, rebuild it, then select the GrandNode.Web project.

  • Host on Linux server

Before you start - please install, configure the nginx server, .NET Core 9.0+ and MongoDB 4.0+

mkdir ~/source
cd ~/source
git clone - b x.xx https://github.com/grandnode/grandnode2.git
cd ~/source/grandnode
dotnet restore GrandNode.sln

Now it's time to rebuild all of our plugins and publish application (command is pretty long because we've combined all commands in a single line, to ease up your work):

sudo dotnet build src/Plugins/Authentication.Facebook && sudo dotnet build src/Plugins/Authentication.Google && sudo dotnet build src/Plugins/DiscountRules.Standard && sudo dotnet build src/Plugins/ExchangeRate.McExchange && sudo dotnet build src/Plugins/Payments.BrainTree && sudo dotnet build src/Plugins/Payments.CashOnDelivery && sudo dotnet build src/Plugins/Payments.StripeCheckout && sudo dotnet build src/Plugins/Shipping.ByWeight && sudo dotnet build src/Plugins/Shipping.FixedRateShipping && sudo dotnet build src/Plugins/Shipping.ShippingPoint && sudo dotnet build src/Plugins/Tax.CountryStateZip && sudo dotnet build src/Plugins/Tax.FixedRate && sudo dotnet build src/Plugins/Widgets.FacebookPixel && sudo dotnet build src/Plugins/Widgets.GoogleAnalytics && sudo dotnet build src/Plugins/Widgets.Slider && sudo dotnet build src/Plugins/Theme.Modern && sudo dotnet publish src/Web/Grand.Web -c Release -o /var/webapps/grandnode 

Optional: Create the service file, to automatically restart your application.

sudo vi /etc/systemd/system/grandnode.service

Paste the following content, and save changes:

[Unit]
Description=GrandNode

[Service]
WorkingDirectory=/var/webapps/grandnode
ExecStart=/usr/bin/dotnet /var/webapps/grandnode/Grand.Web.dll
Restart=always
RestartSec=10
SyslogIdentifier=dotnet-grandnode
User=www-data
Environment=ASPNETCORE_ENVIRONMENT=Production

[Install]
WantedBy=multi-user.target

Enable the service and restart the GrandNode

sudo systemctl enable grandnode.service
sudo systemctl start grandnode.service

Feel free to visit our detailed guide about GrandNode installation.

Online demo

Frontend

https://demo.grandnode.com/

Backend

https://demo.grandnode.com/admin

Demo is restoring once per day to the original state.

Access to the admin panel:

Admin email: [email protected]

Admin password: 123456

Roadmap

We have a clear vision in which direction we would like to develop GrandNode. Ready roadmaps with milestones for future versions of GrandNode can be found in the projects tab.

Contributing

GrandNode is and always will be free and open-source. How to contribute:

  • Star this project on GitHub.
  • Report bugs or suggest features by creating new issues
  • Submit pull requests
  • Become a sponsor and donate to us

Sponsors

Become a sponsor and get your logo on our README on Github with a link to your site. [Become a sponsor]

Why Choose GrandNode?

GrandNode stands out in the crowded e-commerce platform market by offering:

  • Superior Performance - MongoDB and ASP.NET Core ensure lightning-fast page loads
  • Ultimate Scalability - From startup to enterprise, grow without limits
  • Lower Total Cost of Ownership - Free, open-source with no licensing costs
  • Modern Technology Stack - Built with future-proof technologies
  • Extensible Architecture - Build custom modules and integrations

Whether you're launching a single online store or building a complex multi-vendor marketplace, GrandNode provides the tools and performance you need to succeed in today's competitive e-commerce landscape.

Code of conduct

To clarify behavior rules in our community, GrandNode has adopted the code of conduct defined by the Contributor Covenant. For more information see the Code of Conduct.

License

GrandNode is completely free and distributed under the GNU General Public License v3.0. It's available here