1.环境部署
#准备工作
JDK >= 1.8 (推荐1.8版本)
Mysql >= 5.7.0 (推荐5.7版本)
Maven >= 3.0
#运行系统
1、前往Gitee下载页面(https://gitee.com/y_project/RuoYi (opens new window))下载解压到工作目录
2、导入到Eclipse，菜单 File -> Import，然后选择 Maven -> Existing Maven Projects，点击 Next> 按钮，选择工作目录，然后点击 Finish 按钮，即可成功导入。
Eclipse会自动加载Maven依赖包，初次加载会比较慢（根据自身网络情况而定）
3、创建数据库ry并导入数据脚本ry_2021xxxx.sql，quartz.sql
4、打开项目运行com.ruoyi.RuoYiApplication.java，出现如下图表示启动成功。

(♥◠‿◠)ﾉﾞ  若依启动成功ლ(´ڡ`ლ)ﾞ  .-------.       ____     __        |  _ _   \      \   \   /  /    | ( ' )  |       \  _. /  '       |(_ o _) /        _( )_ .'         | (_,_).' __  ___(_ o _)'          |  |\ \  |  ||   |(_,_)'         |  | \ `'   /|   `-'  /           |  |  \    /  \      /           ''-'   `'-'    `-..-'  

5、打开浏览器，输入：(http://localhost:80 (opens new window)) （默认账户/密码 admin/admin123）
若能正确展示登录页面，并能成功登录，菜单及页面展示正常，则表明环境搭建成功

建议使用Git克隆，因为克隆的方式可以和RuoYi随时保持更新同步。使用Git命令克隆

git clone https://gitee.com/y_project/RuoYi.git

2.必要配置

修改数据库连接，编辑resources目录下的application-druid.yml

# 数据源配置
spring:datasource:type: com.alibaba.druid.pool.DruidDataSourcedriverClassName: com.mysql.cj.jdbc.Driverdruid:# 主库数据源master:url: 数据库地址username: 数据库账号password: 数据库密码

修改服务器配置，编辑resources目录下的application.yml

# 开发环境配置
server:# 服务器的HTTP端口，默认为80port: 端口servlet:# 应用的访问路径context-path: /应用路径

部署系统
打包工程文件
在ruoyi项目的bin目录下执行package.bat打包Web工程，生成war/jar包文件。
然后会在项目下生成target文件夹包含war或jar

提示

多模块版本会生成在ruoyi/ruoyi-admin模块下target文件夹

部署工程文件
1、jar部署方式

使用命令行执行：java –jar ruoyi.jar 或者执行脚本：ruoyi/bin/run.bat2、war部署方式
ruoyi/pom.xml中的packaging修改为war，放入tomcat服务器webapps<packaging>war</packaging>

提示

多模块版本在ruoyi/ruoyi-admin模块下修改pom.xml

SpringBoot去除内嵌Tomcat（PS：此步骤不重要，因为不排除也能在容器中部署war）

<!-- 多模块排除内置tomcat -->
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId><exclusions><exclusion><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-tomcat</artifactId></exclusion></exclusions>
</dependency><!-- 单应用排除内置tomcat -->		
<exclusions><exclusion><artifactId>spring-boot-starter-tomcat</artifactId><groupId>org.springframework.boot</groupId></exclusion>
</exclusions>

如果使用Mac需要修改application.yml文件路径profile 如果使用Linux
提示表不存在，设置大小写敏感配置在/etc/my.cnf添加lower_case_table_names=1，重启MYSQL服务
如果提示当前权限不足，无法写入文件请检查application.yml中的profile路径或logback.xml中的log.path路径是否有可读可写操作权限
如遇到无法解决的问题请到Issues (opens new window)反馈，会不定时进行解答。