Documentation

Most common production server errors with Cherokee

  • Page 500

    The most common cause of an Internal Server Error within Cherokee is
    problem of invalid headers. If your cgi script for some reason does
    not send out a headerless (eq. Content-type: text/html) streams, you
    will hit this bug. Check scripts, error log etc. to find out what
    causes it.
  • Page 503

    When an information source is unavailable, the server will return a
    503 for that request. Cherokee will constantly try to find a new
    information sources, but it will take (as most) the total amount of
    defined sources in request to find back a working information
    source. If a 503 stays present, you can safely assume Cherokee is
    unable to start an interpreter or connect to the remote host that
    has the information source defined.
  • Page 400

    If you are repeatedly receiving a 400 error while uploading files to
    a PHP backend, it could very well be related to PHP being the one
    restricting uploads bigger than a certain size. Check the [PHP
    recipe] for more details on how to fix this.
  • CLI: Can’t bind() socket (port=80, UID=1000, GID=1000)

    Most likely Cherokee is unable to start because you are not
    root. And you want to bind the webserver to a privileged port (80).
  • CLI: Can’t bind() socket (port=80, UID=0, GID=0)

    When you are root and get this message. There is a running Cherokee
    instance. The most efficient way to get rid of it:
      killall -s KILL cherokee
      killall -s KILL cherokee-worker

Restarting

  • If you just want to restart the webserver, this will do:

      killall -s HUP cherokee