XERPz Development Environment Setup Guide

Home / XERPz Development Environment Setup Guide

In this guide, you will learn how to set up a complete development environment for running your ERP project after purchasing the source code from Alwajeez Tech.

Whether you are a developer, business owner, or just getting started, this step-by-step tutorial will guide you through installing and configuring everything needed to run, test, and customize the system on your Windows 10 or Windows 11 machine.

No advanced technical experience is required β€” simply follow each step carefully, and you’ll have your ERP system up and running smoothly in no time. πŸš€

πŸ“₯ Download Development Environment Files

Download all required installer files (packaged in one archive):

πŸ“¦ Extracting the Files

The downloaded file is in .7z format, which requires extraction before use.

If you do not have 7zip installed in your machine please download from 7zip website download link.

After installing:

  1. Right-click on dev-env.7z
  2. Click Extract Here or Extract to folder

βœ… You’re Ready to Begin

Once extracted, you can proceed with the installation steps outlined in this guide.

Download links for the installer files all together packaged into a 7zip file:

πŸ“¦ What You Received

You downloaded a file called:

dev-env.7z

After extracting, you will see:

What you will install

  1. Visual Studio 2019 Installer
  2. Microsoft SQL Server 2019
  3. SQL Server Management Studio (SSMS)
  4. Crystal Reports for Visual Studio

⚠️ Before You Start

βœ… System Requirements

  • Windows 10 or Windows 11 (64-bit)
  • Minimum 8 GB RAM (4 GB works, but slower)
  • At least 20 GB free disk space
  • Internet connection (for installation)

πŸ“‚ STEP 1: Extract the Files

  1. Right-click dev-env.7z
  2. Click Extract Here (or use WinRAR / 7-Zip)

πŸ‘‰ You should now see the setup files like in the image above.

πŸ”’ STEP 2: Install Everything (IMPORTANT ORDER)

πŸ‘‰ Install in this exact order:

🟣 1. Install Visual Studio 2019

πŸ“ File: Visual_Studio_Professional_2019.exe

Steps:

  1. Double-click the file
  2. Click Continue
  3. Wait for installer to load

Select Workloads:

βœ” ASP.NET and web development
βœ” .NET desktop development

πŸ‘‰ Click Install

⏳ This may take 15–30 minutes.

🟑 2. Install SQL Server 2019

πŸ“ File: Microsoft_Sql_Server_2019_Standard_Edition.iso

Steps:

  1. Right-click the file β†’ Click Mount
  2. Open the mounted drive
  3. Double-click Setup.exe

Choose:

πŸ‘‰ Basic Installation (Recommended for beginners)

Set:

  • Instance name: SQLEXPRESS (default is fine)

πŸ‘‰ Click Install

⏳ Wait until completed.

πŸ”΅ 3. Install SQL Server Management Studio (SSMS)

πŸ“ File: SSMS_21.exe

Steps:

  1. Double-click the file
  2. Click Install
  3. Wait until finished

πŸ‘‰ Restart your computer if asked.

🟒 4. Install Crystal Reports for Visual Studio

πŸ“ File: Crystal Reports for Visual Studio 13 SP29.EXE

Steps:

  1. Double-click the file
  2. Click Next β†’ Next β†’ Install
  3. Accept all default settings

πŸ‘‰ Finish installation

βš™οΈ STEP 3: Setup Database

  1. Open SQL Server Management Studio (SSMS)
  2. Connect to:Server name: .\SQLEXPRESS Authentication: Windows Authentication
  3. Click Connect

Restore Database

  1. Right-click Databases
  2. Click Restore Database
  3. Select your .bak file (provided with source code)
  4. Click OK

πŸ’» STEP 4: Run the Project

  1. Open Visual Studio 2019
  2. Click Open Project
  3. Select the ERP project folder
  4. Open .sln file

Configure Database Connection

  1. Open Web.config
  2. Update this:
<connectionStrings>
  <add name="Connection_String"
       connectionString="Data Source=.\SQLEXPRESS;Initial Catalog=XERPz;Integrated Security=True;"
       providerName="System.Data.SqlClient" />
</connectionStrings>

Run Project

πŸ‘‰ Press F5

OR

πŸ‘‰ Click Start (IIS Express)

🌐 STEP 5: Access the ERP

Your browser will open automatically:

πŸ‘‰ Example:

http://localhost:12345/

πŸ” Default Login (Example)

  • Username: admin
  • Password: admin

(Check your database if different)

🚨 Common Issues & Fixes

❌ SQL Server Not Connecting

βœ” Make sure service is running
βœ” Use: .\SQLEXPRESS

❌ Project Not Running

βœ” Build solution first (Ctrl + Shift + B)

❌ Crystal Report Error

βœ” Make sure Crystal Reports installed correctly

🎯 You Are Ready!

Congratulations πŸŽ‰
You now have a fully working ERP development environment.

πŸ’‘ Pro Tips

  • Use Visual Studio to customize features
  • Use SSMS to manage database
  • Always backup before changes
  • Test changes locally first

πŸ“ž Need Help?

If you face any issues:

  • Recheck steps carefully
  • Contact support (if included)

πŸš€ Final Note

This ERP is fully customizable.

πŸ‘‰ You can:

  • Modify features
  • Rebrand
  • Build for clients
  • Start your own ERP business

Alternative link for this post:πŸ‘‰ Just follow step-by-step. No advanced skills required.