# Waline

Comment system for web pages: a client script shows the comments and a server stores, moderates and notifies.


Source: https://findsoftware.frbit.cloud/waline/
Last reviewed: 2026-11-03
Listed since: 2026-11-03

## Record

### Links

- home: https://waline.js.org
- repository: https://github.com/walinejs/waline
- docs: https://waline.js.org/en/guide/get-started/
- forum: https://github.com/walinejs/waline/discussions

### Identity

- status: active
- maintainer: lizheming
- maintainerType: individual
- parent: unknown
- firstRelease: 2020
- hqCountry: unknown

### Kind

- category: community
- hosting: node
- language: javascript
- runtime: node
- runtimeMin: node 26
- basedOn: unknown

### Content

- contentStore: unknown
- databases: mongodb, mysql, postgres, sqlite
- adminUi: yes
- headlessApi: unknown
- templating: unknown
- i18n: built-in languages and customizable locale

### Rendering and deploy

- runsAs: always-on
- renderingModes: unknown
- installMethod: Vercel deploy button for the server

### License

- licenseModel: open-source
- license: GPL-2.0, MIT

### Releases

- currentMajor: 3
- latestReleaseDate: 2026-11-03

### Adoption

- githubStargazers: 3158
- packagistDownloads: not applicable
- npmWeeklyDownloads: 12668
- contributors: 127
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: 880
- dependentPackages: 33

### Sources

- urls: https://waline.js.org/en/advanced/intro.html (read 2026-11-03)
- urls: https://api.github.com/repos/walinejs/waline (read 2026-11-03)
- urls: https://waline.js.org/en/guide/get-started/ (read 2026-11-03)
- maintainer: https://waline.js.org/en/advanced/intro.html (read 2026-11-03)
- maintainerType: https://waline.js.org/en/advanced/intro.html (read 2026-11-03)
- language: https://api.github.com/repos/walinejs/waline (read 2026-11-03)
- category: https://waline.js.org/en/advanced/intro.html (read 2026-11-03)
- databases: https://waline.js.org/en/reference/server/env (read 2026-11-03)
- databases: https://waline.js.org/en/reference/server/env (read 2026-11-03)
- databases: https://waline.js.org/en/reference/server/env (read 2026-11-03)
- databases: https://waline.js.org/en/reference/server/env (read 2026-11-03)
- adminUi: https://waline.js.org/en/guide/get-started/ (read 2026-11-03)
- i18n: https://waline.js.org/en/guide/features/i18n.html (read 2026-11-03)
- installMethod: https://waline.js.org/en/guide/get-started/ (read 2026-11-03)
- installMethod: https://waline.js.org/en/advanced/faq.html (read 2026-11-03)
- installMethod: https://waline.js.org/en/advanced/faq.html (read 2026-11-03)
- installMethod: https://waline.js.org/en/guide/get-started/ (read 2026-11-03)
- installMethod: https://waline.js.org/en/guide/deploy/vps.html (read 2026-11-03)
- runtime: https://registry.npmjs.org/@waline/vercel/latest (read 2026-11-03)
- runtimeMin: https://registry.npmjs.org/@waline/vercel/latest (read 2026-11-03)
- runsAs: https://waline.js.org/en/guide/deploy/vps.html (read 2026-11-03)
- license: https://github.com/walinejs/waline (read 2026-11-03)
- license: https://registry.npmjs.org/@waline/client/latest (read 2026-11-03)
- licenseModel: https://github.com/walinejs/waline (read 2026-11-03)
- currentMajor: https://registry.npmjs.org/@waline/client/latest (read 2026-11-03)
- latestReleaseDate: https://registry.npmjs.org/@waline/client (read 2026-11-03)
- firstRelease: https://registry.npmjs.org/@waline/client (read 2026-11-03)
- githubStargazers: https://api.github.com/repos/walinejs/waline (read 2026-11-03)
- contributors: https://api.github.com/repos/walinejs/waline/contributors?per_page=1 (read 2026-11-03)
- npmWeeklyDownloads: https://api.npmjs.org/downloads/range/2026-10-26:2026-11-01/@waline/client (read 2026-11-03)
- dependentPackages: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/%40waline%2Fclient (read 2026-11-03)
- dependentRepos: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/%40waline%2Fclient (read 2026-11-03)

## Notes

Waline is a comment system for web pages. A client script shows the comment list and the comment box on a page, and a server stores the comments and sends notifications. The client loads from unpkg or installs from npm, and the page names the server in its serverURL option. The server is deployed to Vercel from a template or run from a Docker image or as a Node process behind a proxy, as the [get-started guide](https://waline.js.org/en/guide/get-started/) and the [self-host page](https://waline.js.org/en/guide/deploy/vps.html) describe. The project began as a backend for Valine, and its FAQ describes Waline as Valine with a backend.

Comments are stored in the database the server is configured with: MongoDB, MySQL, PostgreSQL or SQLite. The server sends e-mail notifications for replies and new comments and gives an administrator a comment management dashboard. Visitors can register through the comment box, and the first person to register becomes the administrator.

## Worth knowing

The client and the server are separate packages in one repository, and the server's update path differs by host, as the FAQ explains.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0