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.
- uses code from the Cherokee Project under the GNU General Public License, Version 2.
- is licensed under the MIT License.
- packages the code from the Cherokee Webserver into a container format.
- does not modify the Cherokee Webserver code.
Enjoy! :D
To get started, pull the image:
docker pull ghcr.io/managedkaos/cherokee:main
After the pull, run the image:
docker run --rm --name cherokee -d -p 80:80 -p 443:443 -p 9090:9090 ghcr.io/managedkaos/cherokee:main
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 container 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 (Nov 24 2024): Listening on port ALL:9090, TLS
disabled, IPv6 enabled, using poll, 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: B4OUEMXoJYq9yAgZ
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.