How to Deploy the Open‑Source ModernWMS Warehouse System on Linux, Windows, and Docker

Project Overview

ModernWMS is an open‑source lightweight warehouse management system that extracts core WMS functionality from a commercial product. The codebase is cross‑platform, allowing the same source to be built and run on Linux or Windows.

Supported Platforms

Linux

Ubuntu 18.04, 20.04, 22.04 LTS

CentOS Stream 8, 9

RHEL 8 (8.7), 9 (9.1)

Debian 10, 11

openSUSE 15

Windows

Windows 10 (version 1607) or later

Windows Server 2012 or later

Installation

Linux

Download and extract the source archive.

cd /tmp/ && wget https://github.com/fjykTec/ModernWMS/archive/refs/heads/master.zip
unzip master.zip && cd ModernWMS-master

Install .NET SDK 7.0, ASP.NET Core runtime 7.0, and Node.js 16.

wget https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
sudo apt-get update && sudo apt-get install -y dotnet-sdk-7.0 aspnetcore-runtime-7.0
curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash -
sudo apt install -y nodejs

Build the frontend and backend.

# Frontend
cd frontend && yarn && yarn build && cp -rf dist/* /ModernWMS/frontend/
# Backend
cd ../backend && sudo dotnet publish && cp -rf bin/Debug/net7.0/publish/* /ModernWMS/backend/

Compile and install Nginx with required modules.

wget http://nginx.org/download/nginx-1.18.0.tar.gz
tar -zxvf nginx-1.18.0.tar.gz && cd nginx-1.18.0
./configure --prefix=/etc/nginx \
    --with-http_secure_link_module \
    --with-http_stub_status_module \
    --with-http_ssl_module \
    --with-http_realip_module
make && sudo make install

Deploy the built files and start services.

cp -rf /ModernWMS/frontend/* /etc/nginx/html/
sudo systemctl restart nginx   # or run nginx directly
dotnet /ModernWMS/backend/ModernWMS.dll --urls http://0.0.0.0:20011

Windows

Download and extract the source archive.

cd C:\
wget -Uri https://github.com/fjykTec/ModernWMS/archive/refs/heads/master.zip -OutFile master.zip
Expand-Archive -Path master.zip -DestinationPath C:\ModernWMS

Install .NET SDK 7.0 and Node.js 16.

# .NET SDK
wget -Uri https://download.visualstudio.microsoft.com/download/pr/.../dotnet-sdk-7.0.101-win-x64.exe -OutFile dotnet-sdk-7.0.101-win-x64.exe
dotnet-sdk-7.0.101-win-x64.exe /install /quiet /norestart
# Node.js
wget -Uri https://nodejs.org/dist/v16.13.1/node-v16.13.1-x64.msi -OutFile node-v16.13.1-x64.msi
msiexec /i node-v16.13.1-x64.msi /passive /norestart

Build and copy the frontend and backend.

# Frontend
cd C:\ModernWMS-master\frontend && yarn && yarn build && copy-item -Path .\dist\* -Destination C:\ModernWMS\frontend\ -Recurse
# Backend
cd ..\backend && dotnet publish && copy-item -Path .\bin\Debug
et7.0\publish\* -Destination C:\ModernWMS\backend\ -Recurse

Download and start Nginx, then run the backend.

wget -Uri http://nginx.org/download/nginx-1.16.1.zip -OutFile nginx-1.16.1.zip
Expand-Archive -Path nginx-1.16.1.zip -DestinationPath C:
ginx
copy-item -Path C:\ModernWMS\frontend\* -Destination C:
ginx\html\ -Recurse
start C:
ginx
ginx.exe
dotnet C:\ModernWMS\backend\ModernWMS.dll --urls http://0.0.0.0:20011

Docker

Download and extract the source (same as Linux step 1).

Build the Docker image.

cd /tmp/ModernWMS-master/docker
docker build -t modernwms:1.0 .

Run the container, exposing port 80.

docker run -d -p 80:80 modernwms:1.0 /bin/bash ./run.sh

Running the Application

After the backend and web server are started, open a browser and navigate to http://127.0.0.1 (or the server’s IP address). The default login credentials are admin / 1 .

Source Code

Repository URL: https://github.com/fjykTec/ModernWMS