erlyaws/yaws
38.2
Weak · 13 November 2026
40.2k
lines of production code
Erlang
primary language
7
measurements over time
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.