Skip to content
CAI
Software that uses CAICheck a score

erlyaws/yaws

38.2

Weak · 13 November 2026

40.2k

lines of production code

Erlang

primary language

7

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add C source components for PAM authentication and setuid driver

The build system now compiles and installs a new PAM authentication helper (epam) and a setuid Erlang driver (setuid\_drv) into the priv directory. The epam module provides a conversation function for PAM interactions, while setuid\_drv allows the application to switch to a different user identity and query user details. Additionally, a generic hashtable implementation is included to support internal data structures used by these components.

_c\src · high confidence

Add Munin plugins for YAWS server monitoring

New Munin plugins have been added to monitor YAWS server performance, specifically tracking hit counts and bytes sent. These scripts allow administrators to graph these metrics by linking the plugins to the Munin configuration and restarting the munin-node service.

munin · high confidence

Add NetBSD init script for Yaws

A new init script (scripts/netbsd/yaws.sh) has been added to support running Yaws on NetBSD. This script integrates with the NetBSD rc.d system, allowing users to manage the Yaws service via standard commands like start, stop, status, and reload. It respects configuration variables in /etc/rc.conf, such as yaws\_flags and yaws\_id, and defaults to running with the --heart flag if no specific flags are set.

scripts/netbsd, scripts/openbsd · high confidence

Add example appmod demonstrating Yaws API usage

An example application module (myappmod) and its build configuration (Makefile.am) have been added to the www/code directory. This example demonstrates how to implement a Yaws appmod, specifically showing how to access and display request arguments such as appmoddata, appmod\_prepath, and querydata within an HTML response. The build file ensures deterministic compilation of this example module.

www/code · high confidence

Add init scripts and systemd unit for Yaws

Added init scripts for Debian, Red Hat, and SUSE distributions, along with a systemd service unit file, to enable the Yaws web server to be managed as a system service. These scripts provide standard start, stop, restart, reload, and status commands, allowing users to integrate Yaws into their system's service management infrastructure.

(repo-wide) · high confidence

Add macOS startup scripts and documentation for Yaws

This change introduces support for running Yaws as a system service on macOS (Darwin). It adds a README explaining how to enable or disable the service via /etc/hostconfig, a Yaws.StartupItem script that manages starting, stopping, and restarting the daemon using SystemStarter, and a Yaws.plist configuration file defining service dependencies. Users can now automatically start Yaws on reboot or manually control it via SystemStarter commands.

scripts/darwin · high confidence

Add man pages for Yaws server, configuration, API, and SOAP library

The Yaws documentation now includes formal man pages for the main server binary (yaws.1), the configuration file format (yaws.conf.5), the Erlang API for developers (yaws\_api.5), and the SOAP library (yaws\_soap\_lib.5). These pages are installed via the build system, with PDF versions generated for Windows builds, providing users with accessible reference material for command-line options, configuration directives, and available API functions.

man · high confidence

Add multipart and path-concatenation benchmarks for yaws\_server

New benchmarking tools have been added to the contrib/benchmarks directory to help evaluate yaws\_server performance. The suite now includes multipart\_bm.erl, which benchmarks the parsing of multipart POST messages using binary:compile\_pattern, and conc\_path\_bm.erl, which compares the performance of the original yaws\_server conc\_path function against tail-recursive and standard lists module alternatives (lists:append, lists:flatten, lists:concat). These benchmarks can be run via the bench module to generate performance reports.

contrib/benchmarks · high confidence

Add reproducible build support for documentation

The documentation build system now supports reproducible builds by respecting the SOURCE\_DATE\_EPOCH environment variable. When set, the build process uses this timestamp for the generated PDF and PostScript files, ensuring that identical source trees produce bit-for-bit identical documentation artifacts regardless of the build time.

doc · high confidence

Add shopping cart example application

A new shopping cart example application has been added to the www/shoppingcart directory. It demonstrates server-side state management using the Yaws web server, featuring user login/logout flows, session handling via cookies, and dynamic HTML generation with Erlang code.

www/shoppingcart · high confidence

Added FreeBSD startup scripts for Yaws

New startup scripts have been added to support running Yaws as a daemon on FreeBSD. The \scripts/freebsd/yaws\ script provides native rc.d support for FreeBSD 9 and later, while \scripts/freebsd/yaws.sh\ serves as a legacy startup script for FreeBSD versions prior to 9. Both scripts allow users to start, stop, reload, and check the status of the Yaws server, with the default configuration running under the 'default' ID.

scripts/freebsd · high confidence

Added Gentoo Linux packaging and init scripts for Yaws

Users on Gentoo Linux can now install and manage the Yaws web server using the package manager. This change introduces a new ebuild (yaws-2.0.2) that handles installation and provides an example configuration, along with a runscript that enables standard service management commands such as start, stop, reload, and query via the OpenRC init system.

scripts/gentoo · high confidence

Added SNI certificate generation examples for multi-host SSL

This location now includes a README, OpenSSL configuration, and pre-generated certificate/key pairs (for alice.sni.example.com and yaws.sni.example.com) to demonstrate how to create self-signed certificates with multiple subjectAltNames. This enables virtual hosting of several SSL servers on the same IP address using Server Name Indication (SNI).

_ssl/mkcert\altname · high confidence

Added SOAP 1.2 support and updated MIME type mappings

The server now supports SOAP 1.2 web services, enabled by adding the necessary XML Schema Definition (XSD) files for SOAP 1.2 envelopes and WSDL bindings alongside the existing SOAP 1.1 schemas. Additionally, the MIME type database has been updated to the Apache 2021 standard, introducing mappings for modern formats such as gzip, JavaScript, JSON, and WebAssembly, while removing obsolete legacy entries.

priv · high confidence

Added example chat application

The applications/chat directory now contains a complete example chat application, including the Erlang server logic (chat.erl), build configuration (Makefile.am), and web interface files (Yaws scripts and JavaScript). This provides a reference implementation for real-time chat functionality within the Yaws framework.

applications/chat · high confidence

Added rebar3-compatible yawsnode template and legacy release files

This change introduces a new \yawsnode\ template in \rebar2-templates\ designed for rebar3, providing a complete set of configuration and runtime files for deploying a Yaws-based Erlang node. The template includes a \reltool.config\ for building an embedded release, a \runner\ script for managing the node lifecycle (start, stop, restart), a \nodetool\ for remote administration, and configuration files for Yaws and SASL logging. Additionally, legacy release support files are added to \rel.obsolete\, including Windows batch scripts (\yaws.cmd\, \start\_erl.cmd\) and an upgrade escript, ensuring compatibility across different operating systems and deployment scenarios.

rebar2-templates, rel.obsolete · high confidence

Added self-signed certificate generation script

A new shell script (ssl/mkcert/mkcert.sh) and its documentation (ssl/mkcert/README) have been added to the project. This script generates a self-signed SSL certificate and key pair using OpenSSL, with instructions provided for creating wildcard certificates by specifying a common name like \*.mydomain.com.

ssl/mkcert · high confidence

Added test page for relative URL handling

A new test page (www/testdir/index.html) has been added to verify the handling of relative URLs and image sources. This page includes various image and link tags referencing local assets to ensure correct resolution of relative paths within the application.

www/testdir · high confidence

Expanded API records for WebSocket, SOAP, and request context

The include headers now provide comprehensive record definitions for new and enhanced capabilities. \yaws\_api.hrl\ adds fields to the \\#arg{}\ record to expose client IP/port, original vs. rewritten requests, normalized server paths, and detailed path information for appmods and scripts. It also introduces records for HTTP request/response structures, URL parsing, Set-Cookie handling, and full WebSocket frame/state management (\\#ws\_frame\_info{}\, \\#ws\_state{}\). New files \soap.hrl\, \soap-envelope.hrl\, and \wsdl11soap12.hrl\ define the data structures required for SOAP 1.2 and WSDL processing, while \yaws\_dav.hrl\ and \yaws\_lock.hrl\ support WebDAV resource and locking operations.

include · high confidence

Initial Windows installer and startup support for Yaws

This change introduces the first official Windows distribution package for Yaws, enabling users to install and run the web server on Windows via a BitRock InstallBuilder-generated installer. The package includes a C-based startup utility (yaws.exe) that reads the installation path from the Windows registry to correctly configure the Erlang load paths, along with a default configuration file (yaws.conf) and documentation. This provides a native, self-contained installation experience for Windows users, distinct from the Unix build system.

win32 · high confidence

Initial release of the Yaws WebMail application

Introduces a new, stateless webmail application for Yaws that allows users to log in via POP3, view, delete, and send emails, and handle attachments. The application includes a Yaws-based web interface (www/), Erlang backend modules (mail, smtp, attachment, mail\_html), and configuration files for setting up the POP/SMTP servers and session timeouts.

applications/mail · high confidence

Initial release of the Yaws Wiki application

This change introduces the Wiki application, a web-based wiki system built on the Yaws HTTP server. It provides core wiki capabilities including page creation, editing, history viewing, and file attachments. The application features a plugin architecture with example plugins for menus and backlinks, supports image slideshows with automatic thumbnail generation, and allows wiki preferences to be edited directly through the wiki interface. The layout is highly configurable via SSI-based HTML templates, and the system includes utilities for managing zombie pages and backlinks.

applications/wiki · high confidence

Introduction of Yapp: a handler for deploying independent Yaws applications

This change introduces the \yapp\ application, which provides a mechanism to deploy Yaws applications (Yapps) independently of each other. It includes a Yaws \runmod\ and \arg\_rewrite\_mod\ that intercepts requests to map URL paths to specific application docroots and modules. The system features a registry (defaulting to Mnesia, with an optional ETS implementation for non-persistent use) to store mappings, and an admin console accessible via the web to add, list, and remove Yapps at runtime. It also includes a simple example Yapp to demonstrate usage.

applications/yapp · high confidence

New WebSocket and Server-Sent Events example applications

The examples directory now includes new Erlang source files demonstrating advanced WebSocket and Server-Sent Events (SSE) capabilities. The WebSocket examples (\advanced\_echo\_callback.erl\, \basic\_echo\_callback.erl\, \basic\_echo\_callback\_extended.erl\) showcase handling of fragmented messages, asynchronous sends, and custom close code validation using the new \yaws\_api\ callbacks. The \server\_sent\_events.erl\ example demonstrates a gen\_server-based SSE implementation that pushes time-stamped events to clients. A new \Makefile.am\ has been added to build these examples.

examples/src · high confidence

New contrib modules for content negotiation, Mnesia sessions, and debugging

Added four new Erlang modules to the contrib directory: yaws\_content\_negotiation implements RFC 2296 content negotiation logic; yaws\_mnesia\_session provides Mnesia-based storage callbacks for the Yaws session server; yaws\_showarg displays detailed ARG record information for debugging; and ymnesia offers a web interface for viewing and querying Mnesia tables.

contrib · high confidence

Website redesign with XHTML 1.0 and new documentation pages

The Yaws website has been redesigned to use XHTML 1.0 Transitional, introducing a new sidebar navigation layout and updated footer elements. This change adds several new documentation and example pages, including guides for Appmods, Bindings, CGI, Cookies, Embedded mode, haXe Remoting, and Server-Sent Events, along with a dedicated Resources page listing external articles and books.

www · high confidence

Removals

Removal of legacy Erlang application artifacts

The \ebin\ directory has been cleaned of obsolete build artifacts. Specifically, the \erl\_crash.dump\ file (a crash log from an old Erlang emulator version) and the application metadata files for \ewww\ and \yaws\ (\ewww.app\, \yaws.app\) have been deleted. This removes stale configuration and diagnostic data that are no longer part of the active codebase.

ebin · high confidence

Removal of legacy Yaws shell script entry point

The \bin/yaws\ shell script, which previously served as a command-line interface to launch the Yaws Erlang application with support for interactive, debug, and custom config file modes, has been removed from the repository. Users relying on this specific script to start the server will need to use the updated or alternative entry points provided by the project.

bin · high confidence

Security

Security fix for HTTPoxy vulnerability

The server now sanitizes CGI environment variables by skipping the Proxy header, preventing the HTTPoxy vulnerability where an attacker could inject a proxy header to redirect requests.

src · high confidence

Behavioural changes

Added M4 macros for version comparison, colored output, and Erlang detection

The build system now includes three new M4 macros to enhance configuration capabilities. The \AX\_COMPARE\_VERSION\ macro allows for robust semantic version comparisons during the configure step. \COLORED\_ECHO\ enables bold and colored console output for build messages, improving readability. Additionally, \erlang.m4\ provides macros to detect the Erlang/OTP ERTS version, directory, and release, facilitating proper Erlang environment integration.

m4 · high confidence

Added build configuration for Erlang example bytecode

The examples/ebin directory now includes a Makefile.am and a .empty placeholder file to properly manage the installation and cleanup of Erlang BEAM bytecode files. This change ensures that example applications compiled into .beam files are correctly installed to the ERLANG\_INSTALL\_LIB\_DIR and cleaned up during the build process.

examples/ebin · high confidence

Added default Diffie-Hellman parameters and regenerated TLS certificates

The SSL configuration now includes a default 2048-bit Diffie-Hellman parameter file (dhparams.pem) and a helper script to generate unique groups, allowing users to configure stronger key exchange via the new dhfile option in yaws.conf. Additionally, the self-signed snakeoil certificate and private key have been regenerated with updated signature algorithms and without exposing the private key in the certificate file, improving default security posture for local development.

ssl · high confidence

Refactored build and installation scripts with new configuration generation

The installation and build process has been restructured to use a new set of shell scripts (gen-yaws, gen-yaws-conf, rebar-pre-script) that generate the yaws execution script and configuration file from templates. This replaces the previous mangle-based approach and integrates better with rebar. The generated configuration now includes new default settings for connection management, such as keepalive\_maxuses, process\_options for garbage collection tuning, acceptor\_pool\_size, and log\_wrap\_size, providing administrators with more control over server behavior out of the box.

scripts · high confidence

Yaws version bump to 2.3.1 and build system modernization

The project version has been updated to 2.3.1. The build infrastructure has been modernized to support deterministic builds via autotools and rebar3, including the addition of a SECURITY.md policy, a dialyzer warning checker script, and updated configuration files for Erlang/OTP 25.0+ compatibility.

(repo-wide) · high confidence

Test coverage

Migrate test suite to Common Test framework

The test infrastructure has been refactored to use the Erlang Common Test framework instead of the previous in-house testing system. This change introduces a new \test/Makefile.am\ build system, a \testsuite.erl\ core module, and a \README.md\ documenting how to run suites, groups, and individual cases via \make check\. It also adds a new \analyze\_coverdata.escript.in\ script for processing code coverage results and includes new test suites such as \auth\_SUITE\ (covering basic auth, IP-based access control, and multiple authorization headers) and \cookies\_SUITE\ (validating cookie parsing and formatting).

test · high confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

Score

  • CAI 39 → 38 (-0.4)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.3) — scores are not directly comparable.

Lenses

  • Code Health 36 → 34 (-1.8)
  • Architecture 93 → 93 (+0.3)
  • Maturity 61 → 53 (-7.4)
  • Readiness 41 → 39 (-1.5)
  • Security 59 → 59 (+0.0)
  • Event-Driven 35 → 35 (+0.0)
  • Event Sourcing 100 → 100 (+0.0)
  • Accessibility 36 → 42 (+5.5)

Resolved (7)

  • Duplicated block (11–14 lines × 2) (src/yaws_soap12_lib.erl)
  • Duplicated block (7 lines × 2) (src/yaws_soap12_lib.erl)
  • Edited copy of a member (19 corresponding lines) (src/yaws_html.erl)
  • Leaked secret: hardcoded-credential (applications/wiki/src/wiki.erl)
  • Leaked secret: hardcoded-credential (applications/wiki/src/wiki.erl)
  • No ADRs found
  • Off-boarding risk: anonymized user #1

New (53)

  • Edited copies of one member (3 members, 10+ corresponding lines) (src/yaws_api.erl)
  • Edited copies of one member (3 members, 13+ corresponding lines) (src/yaws_jsonrpc.erl)
  • Edited copies of one member (4 members, 14+ corresponding lines) (src/yaws_soap12_lib.erl)
  • Edited copies of one member (4 members, 2+ corresponding lines) (src/yaws_session_server.erl)
  • Edited copies of one member (4 members, 5+ corresponding lines) (src/yaws_cgi.erl)
  • Edited copies of one member (4 members, 6+ corresponding lines) (src/haxe.erl)
  • Edited copy of a member (10 corresponding lines) (src/yaws_html.erl)
  • Edited copy of a member (11 corresponding lines) (src/haxe.erl)
  • Edited copy of a member (11 corresponding lines) (src/yaws_config.erl)
  • Edited copy of a member (11 corresponding lines) (src/yaws_server.erl)
  • Edited copy of a member (12 corresponding lines) (src/haxe.erl)
  • Edited copy of a member (12 corresponding lines) (src/haxe.erl)
  • Edited copy of a member (12 corresponding lines) (src/yaws_config.erl)
  • Edited copy of a member (12 corresponding lines) (src/yaws_html.erl)
  • Edited copy of a member (13 corresponding lines) (src/yaws_exhtml.erl)
  • Edited copy of a member (14 corresponding lines) (src/yaws_compile.erl)
  • Edited copy of a member (14 corresponding lines) (src/yaws_soap12_lib.erl)
  • Edited copy of a member (15 corresponding lines) (src/yaws_websockets.erl)
  • Edited copy of a member (16 corresponding lines) (src/yaws.erl)
  • Edited copy of a member (16 corresponding lines) (src/yaws_soap12_lib.erl)
  • …and 33 more

Changes since last survey

  • 1 commits — 0 feature/other, 1 fixes

By area

  • src/yaws.erl — 1 commit

Notable commits

  • fix: Fix sconf_soptions/1,2 function name

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

erlyaws/yaws was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 13 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit 86ba29f8a82b22cd04cc6716d1e45cd75358a0a8 — the exact code this score is about.
  • Scored under rubric-2026.11.3 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.57+preprod-8ebfb01cf4c0.