Skip to content

Latest commit

 

History

History
280 lines (222 loc) · 10.2 KB

README.md

File metadata and controls

280 lines (222 loc) · 10.2 KB
Raw

ModernWMS - Warehouse Management System

ModernWMS logo

ModernWMS

A simple, complete and open source warehouse management system

License: Apache2.0 Release Version (latest Version) QR Code Support Docker Support i18n Support MySQL8 SQL Server PostgreSQL

repo size GitHub commit activity

GitHub Org's stars GitHub Follows GitHub Forks GitHub Watch Gitee Stars Gitee Forks

.NET Vuetify Cli Vue TypeScript VXE Table Vite NodeJS

Contents

Introduction

The inventory management system is a set of small logistics warehousing supply chain processes that we have summarized from years of ERP system research and development. In the process of work, many of our small and medium-sized enterprises, due to limited IT budget, cannot use the right system for them, but there are real needs in warehouse management, that's how we started the project. To help some people who need it.

Requirements

Linux OS

  • 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 OS

  • Windows 10(1607+),11(21H2+)
  • Windows Server 2012+

Installation

Linux

  • download the source code and compile

    • Step 1, download the source code
    cd /tmp/ && wget https://gitee.com/modernwms/ModernWMS/repository/archive/master.zip
    • Step 2, Install .NET SDK and NodeJS
    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
curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash -
sudo apt install -y nodejs
sudo apt-get install gcc g++ make
sudo npm install -g yarn
    • Step 3, compile frontend and backend
    sudo apt install unzip
cd /tmp/ && unzip master.zip && cd ./ModernWMS-master
mkdir -p /ModernWMS/frontend/ /ModernWMS/backend/
cd /tmp/ModernWMS-master/frontend/ 
sed -i 's#http://127.0.0.1#http://IP address#g' ./.env.production
yarn && yarn build && cp -rf /tmp/ModernWMS-master/frontend/dist/* /ModernWMS/frontend/
cd /tmp/ModernWMS-master/backend/ && sudo dotnet publish && cp -rf /tmp/ModernWMS-master/backend/ModernWMS/bin/Debug/net7.0/publish/* /ModernWMS/backend/
cp -rf /tmp/ModernWMS-master/backend/ModernWMS/wms.db /ModernWMS/backend/
    • Step 4, Install Nginx
    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_realip_module --without-http_rewrite_module --without-http_gzip_module
make && make install
cp -rf /ModernWMS/frontend/* /etc/nginx/html/
nohup /etc/nginx/sbin/nginx -g 'daemon off;' &
cd /ModernWMS/backend/ && dotnet ModernWMS.dll --urls http://0.0.0.0:20011

Windows

  • download the source code and compile
    • Step 1, download the source code
    cd C:\
wget -Uri https://gitee.com/modernwms/ModernWMS/repository/archive/master.zip  -OutFile master.zip
Expand-Archive -Path C:\master.zip -DestinationPath C:\
    • Step 2, Install .NET SDK and NodeJS
    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.101-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 .\node-v16.13.1-x64.msi /passive /norestart
npm install -g yarn
    • Step 3, compile frontend and backend
    md C:\ModernWMS\frontend\
md C:\ModernWMS\backend\
cd C:\ModernWMS-master\backend
dotnet publish 
copy-item -path "C:\ModernWMS-master\backend\ModernWMS\bin\Debug\net7.0\publish\*" -destination "C:\ModernWMS\backend\" -recurse
copy-Item "C:\ModernWMS-master\backend\ModernWMS\wms.db" -Destination "C:\ModernWMS\backend\"
cd C:\ModernWMS-master\frontend  
yarn
yarn build 
copy-item -path "C:\ModernWMS-master\frontend\dist\*" -destination "C:\ModernWMS\frontend\" -recurse
    • Step 4, Install Nginx
    cd C:\
wget -Uri http://nginx.org/download/nginx-1.16.1.zip -OutFile nginx-1.16.1.zip
Expand-Archive -Path C:\nginx-1.16.1.zip -DestinationPath C:\
copy-item -path "C:\ModernWMS\frontend\*" -destination "C:\nginx-1.16.1\html\" -recurse
cd C:\nginx-1.16.1\
start nginx.exe
cd C:\ModernWMS\backend\
dotnet ModernWMS.dll --urls http://0.0.0.0:20011

Docker(Optional)

  • Approach 1, download the image from docker hub

    • Step 1, install docker and download the image
    sudo apt install docker.io
sudo docker pull modernwms/modernwms:1.0
    • Step 2，deploy
    sudo docker run -d -p 20011:20011 -p 80:80  modernwms/modernwms:1.0 ./run.sh
sudo docker ps -a | awk 'NR>1 && $2=="modernwms/modernwms:1.0" {print $1}'
sudo docker exec -it <CONTAINER ID> /bin/bash

    After entering the Docker container, execute the following command in the container.

    grep -rl "http://127.0.0.1:20011" /frontend | xargs sed -i 's#http://127.0.0.1:20011#http://IP address:20011#g'
exit

    restart container

    sudo docker restart <CONTAINER ID>

  • Approach 2, Build your own image

    • Step 1, download the source code
    cd /tmp/ && wget https://gitee.com/modernwms/ModernWMS/repository/archive/master.zip
    • Step 2，Install .NET SDK and NodeJS
    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
curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash -
sudo apt install -y nodejs
sudo apt-get install gcc g++ make
sudo npm install -g yarn
    • Step 3, compile frontend and backend
    sudo apt install unzip
cd /tmp/ && unzip master.zip && cd ./ModernWMS-master
cd /tmp/ModernWMS-master/frontend/ && sed -i 's#http://127.0.0.1#http://IP address#g' ./.env.production
yarn && yarn build && cp -rf /tmp/ModernWMS-master/frontend/dist/* /tmp/ModernWMS-master/docker/frontend/
cd /tmp/ModernWMS-master/backend/ && sudo dotnet publish && cp -rf /tmp/ModernWMS-master/backend/ModernWMS/bin/Debug/net7.0/publish/* /tmp/ModernWMS-master/docker/backend/
cp -rf /tmp/ModernWMS-master/backend/ModernWMS/wms.db /tmp/ModernWMS-master/docker/backend/
    • Step 4, deploy
    sudo apt install docker.io
cd /tmp/ModernWMS-master/docker/
docker build -t modernwms:1.0 .
docker run -d -p 20011:20011 -p 80:80  modernwms:1.0 ./run.sh

Usage

Accessing ip address (http://127.0.0.1 or http://the IP address you depolyed) via web browser 

Account: admin 
Password: 1

Demo

 

image2

image0

image1

Contact

Report a BUG

Submit a suggestion

License

Distributed under the MIT License. See LICENSE.txt for more information.This must be observed.

Donate

If it's helpful to you, you can donate us by alipay,by wechat. Your support will encourage us to continue creating

image3

image4