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

Project Overview

The ModernWMS project is a free, open‑source warehouse management system derived from years of ERP implementation experience. It offers a complete set of WMS functions, cross‑platform support, and a clear code structure, making it suitable for small and medium enterprises.

System Requirements

Linux

Ubuntu 18.04 LTS, 20.04 LTS, 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 on Linux

Download and extract the source code, then install the required runtimes and build the frontend and backend.

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

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

cd /tmp/ && unzip master.zip && cd ModernWMS-master

mkdir -p /ModernWMS/frontend/ /ModernWMS/backend/

cd ./frontend/ && yarn && yarn build && cp -rf ./frontend/dist/* /ModernWMS/frontend/

cd ./backend/ && sudo dotnet publish && cp -rf ./backend/ModernWMS/bin/Debug/net7.0/publish/* /ModernWMS/backend/

Compile and install Nginx, then copy the built frontend files to Nginx’s HTML directory.

cd /tmp/ && 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 && make install

cp -rf /ModernWMS/frontend/* /etc/nginx/html/

dotnet /ModernWMS/backend/ModernWMS.dll --urls http://0.0.0.0:20011

Installation on Windows

Similar steps are performed using PowerShell.

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

Expand-Archive -Path C:\master.zip -DestinationPath C:\

wget -Uri https://download.visualstudio.microsoft.com/download/pr/35660869-0942-4c5d-8692-6e0d4040137a/4921a36b578d8358dac4c27598519832/dotnet-sdk-7.0.101-win-x64.exe -OutFile dotnet-sdk-7.0.101-win-x64.exe

dotnet-sdk-7.0.100-win-x64.exe /install /quiet /norestart

wget -Uri https://nodejs.org/dist/v16.13.1/node-v16.13.1-x64.msi -OutFile node-v16.13.1-x64.msi

msiexec /i .
ode-v16.13.1-x64.msi /passive /norestart

md C:\ModernWMS\frontend\

md C:\ModernWMS\backend\

cd C:\ModernWMS-master\backend && dotnet publish

copy-item -path ".\backend\ModernWMS\bin\Debug
et7.0\publish\" -destination "C:\ModernWMS\backend\" -recurse

copy-item -path ".\backend\ModernWMS\wms.db" -destination "C:\ModernWMS\backend\"

cd C:\ModernWMS-master\frontend && yarn && yarn build && copy-item -path ".\frontend\dist\*" -destination "C:\ModernWMS\frontend\" -recurse

wget -Uri http://nginx.org/download/nginx-1.16.1.zip -OutFile nginx-1.16.1.zip

Expand-Archive -Path C:
ginx-1.16.1.zip -DestinationPath C:\

copy-item -path "C:\ModernWMS\frontend\*" -destination "C:
ginx-1.16.1\html\" -recurse

start .
ginx-1.16.1
ginx.exe

cd C:\ModernWMS\backend && dotnet ModernWMS.dll --urls http://0.0.0.0:20011

Docker Deployment

After building the binaries, copy them into the Docker context and build the image.

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

cd /tmp/ && unzip master.zip && cd ModernWMS-master

cd ./frontend/ && yarn && yarn build && cp -rf ./frontend/dist/* ./docker/frontend/

cd ./backend/ && sudo dotnet publish && cp -rf ./backend/ModernWMS/bin/Debug/net7.0/publish/* ./docker/backend/

cp -rf ./backend/ModernWMS/wms.db ./docker/backend/

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

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

Usage

After the services are running, open a browser and navigate to http://127.0.0.1 (or the host’s IP address). The default credentials are admin / 1.