Check links and anchors in Web pages or full Web sites.
Branch: master
Clone or download
dontcallmedom Merge pull request #15 from w3c/tripu/docker-doc
Add info about Dockerfile to documentation
Latest commit 1d91dde Mar 3, 2017
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin Fix documentation of --dir-redirects commandline option Apr 14, 2016
docs send feedback on github Jul 26, 2016
etc s/forbidden/allowed/ whitelisting easier than blacklisting Jun 23, 2015
images extra paste Jun 23, 2015
t extra paste Jun 23, 2015
MANIFEST extra paste Jun 23, 2015
MANIFEST.SKIP extra paste Jun 23, 2015
META.yml extra paste Jun 23, 2015
Makefile.PL extra paste Jun 23, 2015
NEWS extra paste Jun 23, 2015 Wrap a line that is > 160 chars Feb 28, 2017
SIGNATURE extra paste Jun 23, 2015


This distribution contains the W3C Link Checker.

The link checker can be run as a CGI script in a web server as well as on the command line. The CGI version provides a HTML interface as seen at


To install the distribution for command line use:

#if you have cpanminus installed
cpanm --installdeps .
perl Makefile.PL
make test
make install # as root unless you are using local::lib

To install the CGI version, in addition to the above, copy the bin/checklink script into a location in your web server from where execution of CGI scripts is allowed, and make sure that the web server user has execute permissions to the script. The CGI directory is typically named "cgi-bin" somewhere under your web server root directory.

For more information, please consult the POD documentation in the checklink.pod file, typically (in the directory where you unpacked the source):

perldoc ./bin/checklink.pod well as the HTML documentation in docs/checklink.html.

As a Docker container

You may want to use @stupchiy's Dockerfile, which is based on Ubuntu Linux, and follow his instructions:

$ docker build -t link-checker .                                                                        # Build an image
$ docker run -it --rm link-checker                                                                      # Run a container
$ docker run -it --rm link-checker checklink                                            # Run script directly
$ docker run -it --rm -v "$PWD":/home/checklink link-checker checklink -H > report.html # Write to HTML file

Copyright and License

Written by the following people for the W3C:

Copyright (C) 1994-2015 World Wide Web Consortium, (Massachusetts Institute of Technology, European Research Consortium for Informatics and Mathematics, Keio University). All Rights Reserved. This work is distributed under the W3C Software License in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.