Skip to content
REDbot is lint for HTTP.
Python CSS JavaScript Other
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci
.github
bin fix out type Aug 20, 2019
extra make docker work again Jun 1, 2019
redbot Limit access to local IP addresses by default Sep 12, 2019
src metadata May 12, 2019
test add C0330 to ignore May 20, 2019
.coveragerc Add coverage Mar 23, 2015
.editorconfig add .editorconfig Aug 13, 2017
.gitignore work on test_webui Oct 17, 2018
CONTRIBUTING.md update contributing Aug 12, 2017
Dockerfile PYTHONUNBUFFERED Nov 14, 2018
LICENSE.md Central license / author Mar 12, 2016
Makefile colourize pylint output Sep 12, 2019
README.md Limit access to local IP addresses by default Sep 12, 2019
config.txt Limit access to local IP addresses by default Sep 12, 2019
setup.py Limit access to local IP addresses by default Sep 12, 2019

README.md

REDbot

REDbot is lint for HTTP.

It checks HTTP resources for feature support and common protocol problems. You can use the public instance on https://redbot.org/, or you can install it locally and use it on the command line, or even self-host your own Web checker.

CircleCI

Contributing to REDbot

Your ideas, questions and other contributions are most welcome. See CONTRIBUTING.md for details.

Setting Up Your Own REDbot

Requirements

REDbot needs:

  1. Python 3.6 or greater
  2. thor
  3. markdown
  4. netaddr

Once you have Python, you can install the required libraries with:

pip install thor markdown netaddr

Installing RED

Unpack the REDbot tarball. The relevant files are:

  • bin/redbot_cgi.py - the Web CGI script for running REDbot
  • bin/redbot_cli - the command-line interface
  • redbot/ - REDbot's Python library files
  • redbot/assets/ - REDbot's CSS stylesheet and JavaScript library

To install from source (e.g., if you clone from github):

python setup.py install

installs REDbot's libraries as well as the command-line version as redbot_cli.

Setting up your Web Server

To run REDbot as a CGI script, place redbot_cgi.py where you wish it to be served from by the Web server, and place config.txt in the same directory.

For example, with Apache you can put it in a directory and add these configuration directives (e.g., in `.htaccess, if enabled):

  AddHandler cgi-script .py
  DirectoryIndex redbot_cgi.py

If the directory is the root directory for your server "example.com", this will configure REDbot to be at the URI "http://example.com/".

You can also locate config.txt somewhere else, and indicate its path in an environment variable:

 SetEnv REDBOT_CONFIG /path/to/config.txt

The contents of the assets directory also need to be made available on the server; by default, they're in the 'static' subdirectory of the script's URI. This can be changed using the 'static_root' configuration variable in config.txt.

You should also create the directory referenced by the 'save_dir' configuration variable, and make sure that it's writable to the Web server process. This is where RED stores state files, and you should configure a cron job to regularly clean it. For example:

0 * * * * find /var/state/redbot/ -mmin +360 -exec rm {} ;

Running REDbot as a systemd Service

REDbot can run as a standalone service, managed by systemd. This offers a degree of sandboxing and resource management, as well as process monitoring (including a watchdog function).

To do this, clone the repo to your system and copy extra/redbot.service into the appropriate directory (on most systems, /etc/systemd/system/.)

Modify the file appropriately; this is only a sample. In particular, you will need to adjust the first part of BindReadOnlyPaths to suit the location of the REDbot directory for you.

Then, as root:

systemctl reload-daemon

systemctl enable redbot

systemctl start redbot

By default, REDbot will listen on localhost port 8000. This can be adjusted in config.txt. Running REDbot behind a reverse proxy is recommended, if it is to be exposed to the Internet.

Running REDbot with Docker

If you wish to run REDbot using Docker, get a local copy of the repository, then:

docker build -t redbot .

Start the webserver:

docker run -p 8000:80 redbot

Or, just:

make docker

to run REDbot on port 8000.

Credits

Icons by Momenticon. REDbot includes code from jQuery and prettify.js.

You can’t perform that action at this time.