Halo 2.27: A Java-Based Site Builder That Puts Content First
GitHub describes it as Halo is a powerful, easy-to-use open-source site builder - from personal blogs and knowledge bases to company websites and online stores, Halo helps you build it all in one place, meeting a wide range of website needs. The repository metadata lists Java as its primary language. The metadata lists the GPL-3.0 license. This article stays within the project description and details documented in the GitHub repository README.
At a glance
- What is it?
- Halo is an open-source Java site builder for blogs, knowledge bases, and corporate sites. This review covers its Docker-based setup, plugin ecosystem, and the trade-offs of its GPL-3.0 license.
- Who is it for?
- Adopt Halo if you need a self-hosted, Java-based site builder for a blog, knowledge base, or corporate site, and you value a plugin ecosystem over a monolithic CMS. Avoid it if you require a built-in e-commerce workflow without paying for the commercial edition, or if GPL-3.0 licensing conflicts with your distribution model.
- Can I use it commercially?
- Yes, with conditions. GPL-3.0 is a copyleft licence: if you distribute software that includes it, you must release that software's source code under the same licence. Running it internally without distributing it does not trigger that obligation.
- Is it still maintained?
- Yes. The repository last received commits 2 days ago.
- What is it written in?
- Mainly Java, according to GitHub's language statistics.
Answers come from the project's GitHub data, last synced on November 15, 2026, and from our analysis. They are not legal advice.
Star history
- halo-dev/halo40,283 ★ · +792
| Repository | 2026-08-13 | 2026-11-15 |
|---|---|---|
| halo-dev/halo | 39.5k | 40.3k |
792 Stars in the last 94 days, measured from the daily GitHub snapshot. Compare with other projects
Editorial analysis
What Halo Solves and Who It Serves
Halo is a Java-based open-source site builder aimed at people who want to publish content without building a site from scratch. The README positions it for personal blogs, knowledge bases, corporate websites, and even online stores, though the store capability is tied to the commercial edition. The target user is a developer or technical hobbyist who can run Docker and wants a self-hosted alternative to hosted platforms like WordPress.com or Wix. The community edition is free under GPL-3.0 and includes over 100 free themes and plugins, which suggests a mature ecosystem. This is not a static site generator; it is a dynamic, server-side application that manages content and serves pages. For a team that needs a CMS with a Java backend, Halo fits a specific niche that PHP-based tools like WordPress do not.
How Halo Works: Architecture and Data Flow
The repository is a Java application, and the Docker image `halohub/halo:2.27` runs it as a self-contained service. The core mechanism is straightforward: you run the container, it listens on port 8090, and it stores data in a volume mounted at `/root/.halo2`. The admin interface is accessed via a `/console` path, as shown in the demo credentials. The plugin and theme system is central: the application marketplace provides installable components, and developers can publish their own. The README does not detail the architecture beyond this.
Getting Started: Docker Command and Configuration
The quick start is a single Docker command: `docker run -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 halohub/halo:2.27`. This maps the host port 8090 to the container, and persists data in the `~/.halo2` directory. The README explicitly says this is for evaluation only, not production. For production, it recommends using the 1Panel server management panel, which handles reverse proxy, SSL certificates, and backup tasks. Other deployment methods are referenced in the documentation but not listed in the README. The configuration keys are not shown, but the volume mount path is a key detail: you must persist `/root/.halo2` or you will lose your site data when the container is removed. The demo environment at `demo.halocms.site` lets you try the console with username `demo` and password `P@ssw0rd123..`, which is useful for a quick look before installing.
The Plugin and Theme Ecosystem: A Double-Edged Sword
Halo's strength is its application marketplace, which offers over 100 free themes and plugins. This means you can extend the core beyond a simple blog, adding features like SEO optimization or paid reading, but only if you use the paid plugins in the professional edition. The community edition is free, but the README lists 10 paid plugins that are only available in the professional tier. That creates a split: the core is open source, but some valuable extensions are not. For a developer who wants to build custom plugins, the process is documented, and the `halo-sigs/awesome-halo` repository lists community resources. However, the quality and maintenance of third-party plugins can vary, and you must verify that a plugin works with your Halo version. The release cadence is active, with v2.27.0 on 2026-10-14, v2.27.1 on 2026-10-23 and v2.27.2 on 2026-11-02, so compatibility should be tracked.
Limitations and When Halo Is the Wrong Tool
The most obvious limitation is that e-commerce is not in the community edition. The README lists online store features only in the commercial 'Halo 商城版', which means if you need a store, the free version is not enough. Also, the quick start is Docker-only; if you do not use Docker, you must consult the documentation for manual installation, which is not covered in the README. Another limitation is the GPL-3.0 license, which can be restrictive for proprietary projects. If you plan to modify and redistribute Halo, you must open-source your changes, which may be a dealbreaker for some organizations. For a simple static site, Halo is overkill: it requires a running Java server, whereas a static site generator would be simpler and faster. The demo password is public, which is fine for a demo.
Alternatives: WordPress and Ghost Compared
The most direct alternative is WordPress, which is PHP-based and has a larger plugin ecosystem. WordPress uses a MySQL database and a web server like Apache or Nginx, whereas Halo is Java-based and runs as a single container. The key difference is the language and deployment model: WordPress is ubiquitous on shared hosting, while Halo is more suited to Docker environments. Ghost is another alternative, but it is Node.js-based and focuses on subscription and membership features. Both alternatives have mature ecosystems, but Halo's Java backend may appeal to teams that want to integrate with Java tooling. The choice depends on your stack: if you already run Java services, Halo may fit better; if you want the broadest plugin selection, WordPress is the safer bet.
Maintenance and License Implications
The project is actively maintained, with releases v2.27.0 (2026-10-14), v2.27.1 (2026-10-23) and v2.27.2 (2026-11-02), showing a steady release cycle. Upgrading likely involves pulling a new Docker image and restarting, but the README does not specify a migration process. You should back up the `/root/.halo2` volume before upgrading, as with any data-bearing container. The GPL-3.0 license means that if you distribute a modified version, you must provide source code. This is a common license for open-source projects, but it has implications for commercial use. The README also mentions a commercial 'Halo 专业版' and 'Halo 商城版', which are not open source, so you need to pay for those features. The documentation and community forum are the primary support channels, but there is no mention of paid support in the community edition.
Editorial conclusion
Adopt Halo if you need a self-hosted, Java-based site builder for a blog, knowledge base, or corporate site, and you value a plugin ecosystem over a monolithic CMS. Avoid it if you require a built-in e-commerce workflow without paying for the commercial edition, or if GPL-3.0 licensing conflicts with your distribution model. Before adopting, verify the plugin and theme availability for your niche, test the Docker image on your target hardware, and confirm that the active release cadence matches your update tolerance. Halo is a solid content-first choice, but its commercial tiers and license terms set clear boundaries.
Frequently asked questions
What is Halo, the open source site builder?
Halo is a GPLv3 open source website building tool written in Java, described as covering personal blogs, knowledge bases, enterprise sites and online stores. The site is halo.run, the documentation is docs.halo.run and the community forum is bbs.halo.run. The community edition is free and the README states there are more than 100 free themes and plugins.
How do I try Halo without installing it?
There is a public demo at demo.halocms.site with an admin console at the /console path, and the README publishes a fixed username and password for it. Because those credentials are published in the repository, change them before you point anything real at an instance you run yourself.
How do I run Halo with Docker?
The quick start command is docker run -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 halohub/halo:2.27, which publishes port 8090 and mounts the data and configuration directory. The README says that route is for trial use only and points to the 1Panel panel and the install documentation for reverse proxy, certificates, upgrades and backups.
What are the Halo editions?
The community edition is open source and free under GPLv3. The professional edition adds 10 or more features including a mobile app, AI site building, login by phone number, private deployment and a paid theme and plugin market with 10 paid plugins. The commerce edition adds an integrated online store with product, order and payment handling, including WeChat Pay and Alipay.
Official sources
Add this badge to your README
If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.
[](https://hysenlabs.com/projects/halo-dev-halo)Star history chart for your README
[](https://hysenlabs.com/projects/halo-dev-halo)Was this useful?