Status

Notice and Licensing

The Managed Kaos Cherokee Project (hereafter referred to as "This project") is inspired by the Cherokee Project, specifically the Cherokee Webserver.

This project is not endorsed or governed by the Cherokee Project.

This project uses code from the Cherokee Project under the GNU General Public License, Version 2.

This project is licensed under the MIT License.

This project packages the code from the Cherokee Webserver into a containter format.

This project does not modify the Cherokee Webserver code.

Enjoy! :D

A container for the Cherokee web server

To get started, pull the image:

GitHub Packages (Preferred)¹

docker pull ghcr.io/managedkaos/cherokee:main

Docker Hub

docker pull managedkaos/cherokee

After the pull, run the image:

GitHub Packages (Preferred)

docker run --rm --name cherokee -d -p 80:80 -p 443:443 -p 9090:9090 ghcr.io/managedkaos/cherokee:main

Docker Hub

docker run --rm --name cherokee -d -p 80:80 -p 443:443 -p 9090:9090 managedkaos/cherokee

Confirm operation by browsing to http://localhost.

SSL support is built in! The container creates a self signed certificate at build time. Access the HTTPS version of the site by browsing to https://localhost

To serve a local site, map a directory as a volume to /var/www:

docker run --rm -detach \
    --publish 80:80 \
    --publish 443:443 \
    --publish 9090:9090 \
    --volume /tmp/www:/var/www \
    --name cherokee \
    ghcr.io/managedkaos/cherokee:main

To run the Cherokee Admin UI, start the containter as above. Then run the following command:

docker exec -it cherokee cherokee-admin -b

Use the output from the command to get the user name and the one time password. It should be similar to the following:

Cherokee Web Server 1.2.104 (Oct 15 2022): Listening on port ALL:9090, TLS
disabled, IPv6 enabled, using epoll, 1048576 fds system limit, max. 524281
connections, caching I/O, 4 threads, 131070 connections per thread, standard
scheduling policy

Login:
  User:              admin
  One-time Password: Yp7wb61uMA8Lb4qv

Web Interface:
  URL:               http://localhost:9090/

Open a browser window with localhost:9090. When prompted, enter admin for the username and the password provided by the cherokee-admin command.

Note that the cherokee-admin command is interactive so it will keep the shell open until you end the command by entering CTRL+C twice.

Footnotes

1. Images pulled from GitHub Packages will be more up-to-date as they will be built more frequently than those on Docker Hub. ↩