Set Up an EzyPlatform Development Environment
Updated at 1787839092000Overview
This post covers the development environment you should prepare before building EzyPlatform plugins or themes. It gathers the common setup steps in one reusable place so other plugin guides can point here instead of repeating the same instructions.
After finishing this setup, your machine should have:
- A local EzyPlatform server running against MySQL.
- The EzyPlatform SDK available from the command line.
- IntelliJ IDEA ready to import and run plugin projects.
Prerequisites
Before you start, make sure your machine has:
- JDK 8 (EzyPlatform currently runs on JDK 8).
- MySQL as the database.
- Apache Maven to build the project.
- IntelliJ IDEA (the Community edition is enough).
Install EzyPlatform (without Docker)
First, you need a local EzyPlatform server for your plugin to be installed into and tested against.
Main things to do:
- Install JDK 8 and set the
JAVA_HOMEenvironment variable, then verify withjava -version. - Install MySQL.
- Download the EzyPlatform package and extract it.
- Open
settings/setup.propertiesand fill in your MySQL connection details. - Run
bash cli.sh "console admin"(Linux/MacOS) or.cli.bat "console admin"(Windows). Once you seeEZYHTTP READY, the admin server has started successfully. - Go to
http://localhost:9090/setup-adminto create your first super admin account.
It's also a good idea to set an `EZYPLATFORM_HOME` environment variable pointing to your installation folder. This makes later SDK and plugin development steps easier to manage.
Detailed guide: Install EzyPlatform
Install the EzyPlatform SDK
The EzyPlatform SDK provides the
ezy.sh/ezy.bat command-line tool, which lets you scaffold plugin projects, export modules, link plugins, and more, instead of doing everything by hand.Main things to do:
- Download the EzyPlatform SDK from ezyplatform.com and extract it, for example into
app/ezyplatform-sdk. - Set the
EZYPLATFORM_SDKenvironment variable to point to that folder. - Add
$EZYPLATFORM_SDK/binto yourPATHso you can callezy.sh/ezy.batfrom anywhere. - Clone the
ezyplatform-developmentrepository and runbash build.sh(or.build.baton Windows) to build the shared libraries needed for plugin development.
Detailed guide: Install the EzyPlatform SDK
Install IntelliJ IDEA
Download and install IntelliJ IDEA if you don't already have it. The free Community edition at [github.com/jetbrains/intellij-community](https://github.com/jetbrains/intellij-community) works fine.
This is the IDE you will use to import Maven projects, run startup test classes, and work with plugin/theme source code during development.
What's next
Once the environment is ready, you can continue with the EzyPlatform Plugin Development Quickstart to create your first plugin, learn the generated project structure, and link other plugins when needed.