WebVella/WebVella-ERP - Detailed Review
1. Overview & GitHub Stats
- URL: https://github.com/WebVella/WebVella-ERP
- Stars: 1318
- License: MIT License
- Primary Language: C#
- Last Updated: Recent active development
2. Project Description
WebVella ERP is a comprehensive, free, and open-source enterprise resource planning (ERP) and customer relationship management (CRM) platform built on modern Microsoft technologies. The software is designed with a pluggable architecture, allowing businesses to customize and extend functionality according to their specific needs. Built on ASP.NET Core 9 and RazorPages, it offers excellent performance and cross-platform compatibility, supporting both Linux and Windows hosting environments.
The platform leverages PostgreSQL as its primary database, ensuring robust data management and scalability for businesses of all sizes. Its modular design enables organizations to start with core functionality and gradually add specialized modules as their requirements evolve.
3. What Software Does It Replace?
WebVella ERP serves as a viable alternative to several popular commercial and open-source business management solutions:
Commercial ERP/CRM Replacements:
- SAP Business One
- Microsoft Dynamics 365
- Oracle NetSuite
- Salesforce CRM
- Odoo Enterprise Edition
Open Source Alternatives:
- ERPNext
- Dolibarr
- SuiteCRM
- Apache OFBiz
- Tryton
4. Core Functionality
WebVella ERP offers a comprehensive suite of business management features:
Core ERP Modules:
- Financial management and accounting
- Inventory and supply chain management
- Human resources and payroll
- Project management and tracking
- Sales and purchase order processing
CRM Capabilities:
- Contact and lead management
- Sales pipeline tracking
- Customer service and support ticketing
- Marketing automation
- Reporting and analytics dashboard
Technical Features:
- Pluggable architecture for custom module development
- RESTful API for integration with third-party systems
- Role-based access control and security
- Multi-tenant support
- Real-time reporting and business intelligence
5. Pros and Cons
Pros:
- Cost-Effective: Completely free and open-source with MIT license
- Modern Technology Stack: Built on ASP.NET Core 9 for optimal performance
- Cross-Platform: Supports both Linux and Windows deployment
- Extensible Architecture: Pluggable system allows custom module development
- PostgreSQL Backend: Enterprise-grade database support
- Active Community: Regular updates and community support
- Self-Hosted: Complete data control and privacy
Cons:
- Steeper Learning Curve: Requires .NET development knowledge for customization
- Smaller Ecosystem: Fewer pre-built modules compared to established solutions
- Documentation Gaps: Some advanced features may lack comprehensive documentation
- Limited Third-Party Integrations: Smaller marketplace compared to commercial alternatives
6. Detailed Installation Guide (Self-host)
Prerequisites
- Ubuntu 20.04 LTS or later (recommended)
- .NET 9.0 SDK or runtime
- PostgreSQL 12+ database server
- Nginx (for reverse proxy)
- Superuser access on the server
Step-by-Step Installation
1. System Preparation
# Update system packagessudo apt update && sudo apt upgrade -y
# Install essential packagessudo apt install -y curl wget gnupg software-properties-common
2. Install .NET 9.0 Runtime
# Add Microsoft package repositorywget https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb -O packages-microsoft-prod.debsudo dpkg -i packages-microsoft-prod.debrm packages-microsoft-prod.deb
# Install .NET runtimesudo apt updatesudo apt install -y aspnetcore-runtime-9.0
3. Install and Configure PostgreSQL
# Install PostgreSQLsudo apt install -y postgresql postgresql-contrib
# Start and enable PostgreSQLsudo systemctl start postgresqlsudo systemctl enable postgresql
# Create database and usersudo -u postgres psql -c "CREATE DATABASE webvella_erp;"sudo -u postgres psql -c "CREATE USER webvella_user WITH PASSWORD 'your_secure_password';"sudo -u postgres psql -c "GRANT ALL PRIVILEGES ON DATABASE webvella_erp TO webvella_user;"
4. Install Nginx
sudo apt install -y nginxsudo systemctl start nginxsudo systemctl enable nginx
5. Download and Configure WebVella ERP
# Create application directorysudo mkdir -p /var/www/webvella-erpcd /var/www/webvella-erp
# Download latest release (check GitHub for latest version)sudo wget https://github.com/WebVella/WebVella-ERP/releases/download/vX.X.X/WebVella-ERP.zipsudo unzip WebVella-ERP.zip
# Set proper permissionssudo chown -R www-data:www-data /var/www/webvella-erpsudo chmod -R 755 /var/www/webvella-erp
6. Configure Application Settings
# Edit appsettings.json with your database configurationsudo nano /var/www/webvella-erp/appsettings.json
Update the connection string:
{ "ConnectionStrings": { "DefaultConnection": "Host=localhost;Database=webvella_erp;Username=webvella_user;Password=your_secure_password" }}
7. Create Systemd Service
sudo nano /etc/systemd/system/webvella-erp.service
Add the following content:
[Unit]Description=WebVella ERP ApplicationAfter=network.target
[Service]WorkingDirectory=/var/www/webvella-erpExecStart=/usr/bin/dotnet /var/www/webvella-erp/WebVella.Erp.Web.dllRestart=alwaysRestartSec=10KillSignal=SIGINTSyslogIdentifier=webvella-erpUser=www-dataEnvironment=ASPNETCORE_ENVIRONMENT=Production
[Install]WantedBy=multi-user.target
8. Configure Nginx Reverse Proxy
sudo nano /etc/nginx/sites-available/webvella-erp
Add the following configuration:
server { listen 80; server_name your-domain.com;
location / { proxy_pass http://localhost:5000; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection keep-alive; proxy_set_header Host $host; proxy_cache_bypass $http_upgrade; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; }}
9. Final Setup Steps
# Enable Nginx sitesudo ln -s /etc/nginx/sites-available/webvella-erp /etc/nginx/sites-enabled/
# Test Nginx configurationsudo nginx -t
# Reload Nginxsudo systemctl reload nginx
# Start WebVella ERP servicesudo systemctl enable webvella-erpsudo systemctl start webvella-erp
# Check service statussudo systemctl status webvella-erp
10. Initial Setup
- Open your web browser and navigate to your server’s IP or domain
- Follow the initial setup wizard to configure admin credentials
- Set up your organization details and initial modules
Troubleshooting Tips
- Check logs:
sudo journalctl -u webvella-erp -f
- Verify database connection:
sudo -u postgres psql -d webvella_erp
- Ensure firewall allows HTTP/HTTPS traffic
- Verify file permissions in the application directory
Your WebVella ERP instance should now be running and accessible via your web browser. The platform offers extensive documentation for further customization and module development.