{
  "id": 6942960,
  "title": "Run YunCMS with Docker Compose: MySQL 8.4 Included",
  "url": "https://urgent.news/2026/09/12/run-yuncms-with-docker-compose-mysql-8-4-included",
  "topic": "tech",
  "section": "Tech",
  "published": "2026-09-12T15:22:45.000Z",
  "source": {
    "name": "Dev.to",
    "slug": "dev-to",
    "url": "https://dev.to/yunsoft/run-yuncms-with-docker-compose-mysql-84-included-4hlb"
  },
  "original_language": "en",
  "account": "This guide explains how to run the YunCMS open-source content management system using Docker Compose. YunCMS includes MySQL 8.4 for data storage and runs the CLI, REST API, and React Studio all within the same container image. The Docker Compose configuration creates two services, MySQL and YunCMS, along with two persistent volumes: mysql-data for MySQL tables and yuncms-data for project settings and files.\n\nTo get started, ensure you have Docker Engine with Compose plugin or Docker Desktop installed. For production deployments, additional persistent storage and a reverse proxy terminating TLS may be required. Check the required Docker version and ensure the necessary Node.js and npm tools are already inside the YunCMS image.\n\nDownload the official Compose files to an empty directory and create a .env file to set strong passwords for the database and root user. Pin a specific YunCMS image version in the .env file to avoid automatic updates. Start MySQL first using docker compose up -d mysql and verify its health status. Initialize YunCMS with the init command, providing the necessary database credentials from the .env file.\n\nOnce initialized, start the YunCMS service and verify its readiness using the health and ready endpoints. The image health check will only mark the container as healthy when MySQL and other dependencies are available. Never commit the .env file to version control, as it contains sensitive passwords and configuration.\n\nTo stop the YunCMS service without losing data, use docker compose stop yuncms. For backups, create a backup before maintenance by stopping the YunCMS service, running a backup command, and copying the backup files to an external location. When updating to a new YunCMS version, stop the service, create a backup, update the YUNCMS_IMAGE version in the .env file, pull the new image, and start the service again. Verify the updated installation by checking the health status, login, and file permissions.",
  "summary": "Disclosure: YunCMS is developed and maintained by Yunsoft Software. This guide covers our own open-source project. It was verified against yunsoftofficial/yuncms:0.1.22 on September 12, 2026. The YunCMS 0.1.x line is pre-stable, so interfaces and behavior may change between releases. You may not want to prepare the right Node.js version, npm and a separate MySQL server just to evaluate a…",
  "key_points": [
    "YunCMS runs with MySQL 8.4 using Docker Compose",
    "Requires Docker Engine or Docker Desktop installation",
    "Persistent volumes for MySQL and project data"
  ],
  "editors_take": null,
  "illustration": null,
  "coverage": {
    "outlets": 1,
    "also_reported_by": []
  },
  "ai_generated": true,
  "disclaimer": "Summaries, key points and the editor’s take are written by software from other outlets’ reporting and may contain errors — always check the linked original."
}