Skip to main content

MyEMS FAQ: License, Protocols, Installation, and Enterprise

1. What's EMS?​

Energy Management System (EMS) is management system to establish an energy policy, objectives, energy targets, action plans and process to archive the objectives and energy targets.

2. What scenarios are suitable for MyEMS?​

MyEMS is an energy management system suitable for places that require monitoring and management of energy usage. For example: Factory: can be used to monitor energy consumption on production lines, thereby optimizing production processes and reducing energy costs; Office building: can be used to monitor the energy consumption of air conditioning, lighting and other equipment, in order to improve energy efficiency and save energy; School: can be used to monitor the energy consumption of buildings such as teaching buildings and dormitories, in order to better manage and plan campus resources; Commercial complex: can be used to monitor the energy consumption of buildings such as shopping malls, hotels, and office buildings, in order to reduce operating costs and improve management level. MyEMS is suitable for any location that requires precise management of energy usage.

3. Is MyEMS an open-source energy management system?​

Yes. The MyEMS Community Edition is free under the MIT license. It collects, analyzes, and reports electricity, water, gas, cooling, and heating for buildings, factories, malls, hospitals, and campuses. Community Edition users must keep the MyEMS copyright notice and logo. Details are in the Community Edition comparison.

4. Does MyEMS follow ISO 50001?​

MyEMS is designed with reference to ISO 50001 (GB/T 23331-2020). It records energy data, compares periods, and produces energy and carbon reports that an energy management process can use. MyEMS does not replace an organization's own ISO 50001 management system or a certification audit.

5. Does MyEMS support Modbus?​

Yes. The Community Edition acquires data with Modbus TCP, and also with BACnet/IP, Siemens S7, and OPC UA. The Enterprise Edition adds Modbus RTU, a Modbus TCP server that publishes data, and DTU software that forwards Modbus RTU and Modbus TCP between the site and the cloud. See Community Edition and Enterprise Edition.

6. Can MyEMS monitor a microgrid?​

Microgrid monitoring is an Enterprise Edition feature. In MyEMS, a microgrid is a group of interconnected photovoltaic generation, energy storage batteries, loads, the grid, and generators. The Community Edition covers meters, spaces, equipment, and their energy, cost, and carbon reports, and does not include the microgrid application.

7. How can MyEMS be installed?​

Install the database, then the application. The database scripts run on MySQL 8.0 or later, MariaDB 10.5 or later, SingleStore, GoldenDB, OceanBase, or GreatDB. Application guides cover Debian/Ubuntu, CentOS/RHEL and related distributions, Windows, Docker on Linux, macOS, and Windows, Docker Compose, Podman, Raspberry Pi, openEuler, Anolis OS, Kylin, SUSE, Fedora, Fedora CoreOS, and FreeBSD. Start with Installation.

8. What is the difference between the Community Edition and the Enterprise Edition?​

The Community Edition is free under the MIT license. It includes data acquisition, meters, spaces, equipment, energy, cost, and carbon reports, plus the web UI, the admin UI, and the REST API. The Enterprise Edition is licensed per project. It adds options such as custom branding, Kubernetes, SQL Server, Oracle, photovoltaic plants, energy storage, wind farms, virtual power plants, microgrids, and a fault-detection rule engine. Compare them in Community Edition and Enterprise Edition.

Not in the Community Edition. The copyright notice and logo must stay. Changing the name and logo is an Enterprise Edition option, licensed per project.

10. Which databases does MyEMS support?​

The Community Edition uses MySQL-compatible databases: MySQL, MariaDB, Percona Server for MySQL, SingleStore, and OceanBase. The install scripts also cover GoldenDB and GreatDB. SQL Server and Oracle are Enterprise Edition options.

11. Does MyEMS calculate carbon emissions?​

Yes. The Community Edition includes carbon dioxide emission reports for meters, virtual meters, offline meters, spaces, equipment, tenants, stores, shopfloors, and combined equipment.

12. Does MyEMS provide an API?​

Yes. The Community Edition includes a REST API written in Python for system configuration, energy reports, and Excel export. The call list is in the API manual.

13. What is MyEMS built with?​

The web UI is React. The admin UI is AngularJS 1.x. The API is Python. The database is MySQL-compatible.

14. Can MyEMS run in Docker or on a cloud?​

Yes. The Community Edition supports Docker and can run on AWS, Microsoft Azure, Alibaba Cloud, or a private cloud. Docker Compose and Podman are covered in Installation. Kubernetes is an Enterprise Edition option.

15. Does MyEMS monitor photovoltaic plants and energy storage?​

Photovoltaic power stations, energy storage power stations, and wind farms are Enterprise Edition applications for monitoring and operating those plants. The Community Edition can still report the energy, cost, and carbon of the meters and equipment attached to a site.

16. Is there a limit on meters or data points?​

The Community Edition sets no license cap on data points, meters, spaces, equipment, tenants, stores, shopfloors, or combined equipment. The practical limit is the capacity of the server.

17. Where is the source code, and how do I get help?​

The source code is at GitHub and Gitee. Community support is through the QQ and WeChat groups on the Community Edition page. An online demo is at myems.cloud. Email, telephone, and remote-desktop support are Enterprise Edition services. See Contact Us.

18. Does MyEMS detect equipment faults?​

The Community Edition includes work orders for repair, inspection, and installation records. A rule engine that evaluates fault rules and sends notifications is an Enterprise Edition option.

19. Does MyEMS support BACnet?​

Yes. The Community Edition collects building-automation data with BACnet/IP. The Enterprise Edition can also publish data with a BACnet server.

20. Does MyEMS support Siemens S7?​

Yes. The Community Edition includes a collector for Siemens S7 PLCs.

21. Does MyEMS support OPC UA?​

Yes. The Community Edition reads an OPC UA server. The Enterprise Edition adds OPC DA and an OPC UA server that publishes data.

22. Can MyEMS export Excel, Word, and PDF?​

Yes. The Community Edition exports a real Excel workbook, a real Word document, and a real PDF. The files can contain tables and line, column, and pie charts. The Excel file is a workbook, not a CSV.

23. Does MyEMS include AI analysis?​

Yes. The Community Edition can write analysis conclusions and energy-saving and operations recommendations by calling the DeepSeek and OpenAI APIs. The Enterprise Edition adds LLM function calling, an MCP server, and AI skills.

24. Can MyEMS compare two periods?​

Yes. Comparisons can be year on year, month on month, a freely chosen pair of periods, or no comparison.

25. What is a virtual meter?​

A virtual meter calculates energy from an equation over other meters. The Community Edition reports its energy, carbon dioxide, cost, and comparisons.

26. What is an offline meter?​

An offline meter is entered or imported instead of being polled. The Community Edition reports its energy, carbon dioxide, cost, and batch analysis.

27. What is master-meter and submeter balance?​

It compares a master meter with the submeters under it, so a difference between the total and the parts can be seen. This report is in the Community Edition.

28. Does MyEMS show an energy flow diagram?​

Yes. The Community Edition includes an energy flow diagram.

29. Does MyEMS show the power distribution system?​

Yes. The Community Edition includes a distribution-system view for live electrical data.

30. Can MyEMS bill tenants?​

Yes. The Community Edition includes tenant bills, together with tenant energy, carbon, cost, load, statistics, batch analysis, and comparison.

31. What is a store in MyEMS?​

A store is a retail or chain-store object. The Community Edition gives it a dashboard and reports for energy category, energy item, carbon, cost, load, statistics, batch analysis, and comparison.

32. What is a shopfloor?​

A shopfloor is a production-floor object. The Community Edition gives it the same style of dashboard and energy, carbon, cost, load, statistics, batch analysis, and comparison reports as a store.

33. What is combined equipment?​

Combined equipment groups several pieces of equipment, such as a chiller plant. The Community Edition reports its energy, carbon, cost, output, income, efficiency, and load.

34. Can MyEMS report output, income, and efficiency?​

Yes. Spaces, equipment, and combined equipment in the Community Edition have output, income, and efficiency data.

35. Does MyEMS monitor indoor environment?​

Yes. A space in the Community Edition has an environment monitor in addition to energy data.

36. Does MyEMS include a knowledge base?​

Yes. The knowledge base is part of the Community Edition.

37. What work orders does MyEMS include?​

The Community Edition includes work orders for repair records, inspection records, and installation records.

38. What does a meter energy report contain?​

It can show the reporting-period total, the base-period total, tons of standard coal, tons of carbon dioxide, the trend, related parameters, and detailed data. Results can be exported to Excel.

39. Which energy types does MyEMS cover?​

The usual types are electricity, water, gas, cooling, and heating, together with carbon dioxide. Energy categories are configuration, so a project can add another type.

40. Can the Community Edition be used commercially?​

Yes. It is free under the MIT license, including commercial use. The MyEMS copyright notice and logo must remain.

41. How is the Enterprise Edition priced?​

It is paid per project. The license for that project is lifetime, and custom development can be included.

42. Can MyEMS run on Kubernetes?​

Yes. The public demo at myems.cloud runs on Alibaba Cloud Kubernetes.

43. Does MyEMS support MQTT?​

MQTT is an Enterprise Edition option. A subscriber can ingest data, and a publisher can send data out.

44. Does MyEMS support Apache Kafka?​

Kafka is an Enterprise Edition option. A consumer can ingest data, and a producer can send data out.

45. Does MyEMS support OPC DA?​

OPC DA is an Enterprise Edition option. OPC UA collection is already in the Community Edition.

46. Does MyEMS support IEC 61850?​

IEC 61850 is an Enterprise Edition option.

47. Does MyEMS support IEC 60870-5?​

The Enterprise Edition lists IEC 101, IEC 103, and IEC 104.

48. Can MyEMS connect to a building management system?​

The Community Edition already collects BACnet/IP, Siemens S7, and OPC UA. The Enterprise Edition adds Johnson Controls Metasys API, Honeywell EBI, and Siemens Desigo CC.

49. Can MyEMS read weather data?​

The QWeather API is an Enterprise Edition option.

50. Can MyEMS ingest another database?​

The Enterprise Edition can ingest MySQL, Microsoft SQL Server, PostgreSQL, Oracle, MongoDB, InfluxDB, and TDengine. Those are sources. The MyEMS databases themselves remain MySQL-compatible unless you take the SQL Server or Oracle deployment option.

51. Does MyEMS record energy savings?​

Recording savings for spaces, equipment, meters, virtual meters, offline meters, tenants, stores, shopfloors, and combined equipment is an Enterprise Edition option.

52. Does MyEMS store an energy plan?​

Energy-plan data for those same objects is an Enterprise Edition option. The schema also has an hourly plan database, myems_energy_plan_db.

53. How is a carbon report different from a carbon footprint analysis?​

A Community Edition carbon report is carbon dioxide calculated from energy and emission factors. Carbon footprint analysis is an Enterprise Edition option.

54. Can MyEMS forecast energy use?​

Energy-consumption forecasting is an Enterprise Edition option. Hourly forecast values have their own database, myems_energy_prediction_db.

55. Can MyEMS totalize equipment runtime?​

Equipment runtime totalization is an Enterprise Edition option.

56. Can MyEMS control equipment remotely?​

Remote control of equipment is an Enterprise Edition option.

57. How does MyEMS send alarms?​

The Enterprise Edition includes a fault-detection rule engine and alarms through Alibaba Cloud SMS. The fault database can hold email, SMS, web, and WeChat messages.

58. Is there a MyEMS mobile app?​

iOS, Android, and a WeChat mini program are Enterprise Edition options. The Community Edition uses the web UI and the admin UI.

59. Can other systems read MyEMS through an industrial protocol?​

The Enterprise Edition can publish with a BACnet server, a Modbus TCP server, an OPC UA server, MQTT, and Kafka.

60. Can MyEMS upload data to a government energy platform?​

The Enterprise Edition includes a protocol for uploading to provincial or municipal online-monitoring platforms for key energy-consuming units.

61. What is a virtual power plant in MyEMS?​

It is an Enterprise Edition application. It aggregates distributed generation, flexible loads, energy storage, and other dispersed resources so they can take part in power-system optimization and electricity-market trading.

62. Does MyEMS monitor a wind farm?​

A wind-farm application for monitoring and operations is an Enterprise Edition option.

63. Can MyEMS plan photovoltaic, storage, and charging capacity?​

The Enterprise Edition includes a planning tool for distributed photovoltaic, energy storage, charging, and similar equipment. It covers capacity and investment-return analysis.

64. Does MyEMS include Node-RED?​

Node-RED low-code programming is an Enterprise Edition option.

65. What is the MyEMS DTU?​

DTU software is an Enterprise Edition option. The client and server forward Modbus RTU and Modbus TCP between the site and the cloud.

66. What is LLM function calling in MyEMS?​

It is an Enterprise Edition option that lets a large language model call specific MyEMS APIs to answer a question.

67. What is the MyEMS MCP server?​

It is an Enterprise Edition Model Context Protocol service, so an AI model can access MyEMS through that protocol.

68. What is an AI skill in MyEMS?​

An AI skill is an Enterprise Edition unit of work. It chains several MyEMS tool calls through MCP or function calling, with energy-domain rules, and completes a multi-step analysis.

69. Is there a graphics drawing tool?​

A graphics drawing tool is an Enterprise Edition option.

70. What is the advanced reporting engine?​

It is an Enterprise Edition option. A report has a definition, a template, a schedule, and email. Generated files are kept in myems_reporting_db.

71. What training and on-site help are available?​

Enterprise services include online training, face-to-face training, email, telephone, WeChat, remote desktop, and on-site support.

72. Can I get a formal invoice and contract?​

Formal invoices and contracts are an Enterprise Edition service.

73. Can MyEMS be integrated with another system as a paid service?​

Yes. Enterprise services include third-party integration, bidding support, and custom development.

74. Where are the MyEMS Docker images?​

Community images are published at Docker Hub. Installation steps for Docker, Docker Compose, and Podman are under Installation.

75. What is in the online demo?​

myems.cloud is a site of about one million square meters, with 179 meters, 284 data points, and 18 kinds of space. It runs on Alibaba Cloud Kubernetes, and a collector on site uploads the data. Ask for an account through Contact Us.

76. Which kinds of sites are shown in the demo?​

The demo spaces include a municipal government, office building, mall, hotel, museum, factory, chain stores, residential complex, hospital, university, airport, railway station, farm, apartment, subway station, stadium, utility plant, and data center.

77. How many databases does MyEMS use?​

Thirteen. They cover master data, raw history, hourly energy, billing, carbon, baseline, an 8,760-hour model, plan, prediction, fault messages, users, reports, and production. The design is in Database Design.

78. How is energy stored?​

Energy, cost, and carbon are stored as hourly values. A report totals the hours in the period you select. Cost and carbon are calculated from energy. They are not read from the meter as money or as carbon dioxide.

79. How are cost and carbon calculated?​

Cost is hourly energy valued with the tariff. Carbon dioxide is hourly energy multiplied by an emission factor. After a tariff or factor change, rerunning that period updates the history. Collection does not have to be repeated.

80. What tariffs does MyEMS support?​

Tariffs include time-of-use prices. The peak types are sharp (toppeak), peak (onpeak), flat (midpeak), valley (offpeak), and deep valley (deep). Time-of-use is not a single coefficient, so aggregation applies the price that belongs to each hour.

81. How are emission factors defined?​

An energy category can carry an emission factor, and a factor can also be bounded by time. Carbon reports use those factors to turn energy into carbon dioxide.

82. What is a data point?​

A data point is one address on a data source, such as a Modbus register or a BACnet object. A meter is bound to points. Points are configuration and do not use a uuid. The Community Edition sets no license cap on the number of points.

83. What happens to bad meter readings?​

Cleaning looks for values outside a physical range, gaps inside a period, and cumulative readings that go backwards after a meter change or a communication fault. Some values are corrected. Others are flagged and left out of later aggregation.

84. Do MyEMS services call each other?​

No. Collectors, normalization, cleaning, aggregation, and the API exchange data through the databases. A schema change therefore affects every service that reads that table.

85. Which processes are in a standard installation?​

The web UI listens on port 80, the admin UI on 8001, and the API on 8000. MySQL uses 3306. Collectors cover Modbus TCP, BACnet/IP, OPC UA, and Siemens S7. Normalization, cleaning, and aggregation run on a schedule and do not listen for HTTP. Ports can be changed. See Architecture Design.

86. Should MySQL be open to the internet?​

No. Keep MySQL and the API on the internal network. Publish the web UI, and let nginx proxy API calls. The admin UI is better kept on an internal network or a VPN.

87. What should be checked after installation?​

Change the initial administrator password at first login. Then open the API version, log in, open one analysis page, and confirm that one collected value has arrived. Details are in Installation.

88. Does the Modbus collector pick up new configuration without a restart?​

No. The Modbus collector reads data sources and points when it starts. After a change, restart that collector and then check that values are arriving. The BACnet collector can load the new configuration automatically.

89. Which Modbus function codes are supported?​

The Modbus TCP collector supports function codes 01, 02, 03, 04, and 23. A point address stores the slave id, function code, register offset, register count, data format, and a byte-swap flag.

90. Can MyEMS run on a Raspberry Pi?​

Yes. Install the database first, then follow the Raspberry Pi guide under Installation.

91. Can MyEMS run on Windows?​

Yes. There is a native Windows guide and a Docker-on-Windows guide under Installation.

92. Can PostgreSQL be the MyEMS database?​

Not in the Community Edition. Those databases are MySQL-compatible. The Enterprise Edition can deploy MyEMS on SQL Server or Oracle, and it can ingest from PostgreSQL. Ingest does not turn PostgreSQL into the system database.

93. Does the user interface support multiple languages?​

The web UI uses i18next, and names are stored as UTF-8. This documentation site is published in 20 languages. The interface language comes from the front-end resources.

94. How do users and API clients sign in?​

A person signs in and then sends User-UUID and Token headers. A program may send an API-Key instead. Privileges are administrator, read-only, or a custom privilege stored as JSON. Separate sites in one instance are organized as a space tree, not as separate databases.

95. Can configuration be exported and imported?​

Yes. Configuration objects have JSON export and import. Import matches existing objects by uuid, which is how a configuration moves between environments.

96. Where do uploaded files go?​

Report templates and similar uploads use a shared upload directory. In Docker, the API and the admin UI must mount the same host path, or a template uploaded in admin is invisible to the API.

97. What is the 8,760-hour energy model?​

myems_energy_model_db stores one value for each hour of a typical non-leap year, for the same kinds of objects as the hourly energy database. The hour is hour_of_year, not a timestamp.

98. Can MyEMS store production output?​

Yes. myems_production_db stores products, teams, shifts, and hourly production counts. Output is used with energy when a space, equipment, or combined equipment reports efficiency.

99. Who publishes MyEMS, and how do I reach them?​

Beijing Haishi Software Co., Ltd. publishes MyEMS. Contact Zhang Nengyuan by phone or WeChat at (+86) 13011132526, by email at zny@myems.org, on LINE as myems, or by WhatsApp. See Contact Us.

100. What limits a single MyEMS deployment?​

The Community Edition has no license cap on points, meters, or spaces. The practical limits are server capacity, database write rate, and how fast the field devices can be polled. For many separate projects, run one instance per project. Read replicas are an extension, not a built-in feature.