https://github.com/managedkaos/cherokee
Dockerfiles for containers running the Cherokee web server.
https://github.com/managedkaos/cherokee
docker-image hacktoberfest webserver
Last synced: 9 months ago
JSON representation
Dockerfiles for containers running the Cherokee web server.
- Host: GitHub
- URL: https://github.com/managedkaos/cherokee
- Owner: managedkaos
- License: mit
- Created: 2017-01-11T06:38:29.000Z (over 9 years ago)
- Default Branch: main
- Last Pushed: 2025-03-22T22:21:28.000Z (over 1 year ago)
- Last Synced: 2025-09-11T08:45:51.193Z (9 months ago)
- Topics: docker-image, hacktoberfest, webserver
- Language: Dockerfile
- Homepage:
- Size: 118 KB
- Stars: 6
- Watchers: 3
- Forks: 1
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Status
# Notice and Licensing
The Managed Kaos Cherokee Project (hereafter referred to as "This project") is inspired by the [Cherokee Project](https://github.com/cherokee), specifically the [Cherokee Webserver](https://github.com/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](https://github.com/cherokee/webserver/blob/master/COPYING).
- is licensed under the [MIT License](https://github.com/managedkaos/cherokee/blob/main/LICENSE).
- packages the code from the Cherokee Webserver into a container format.
- does not modify the Cherokee Webserver code.
Enjoy! :D
# A container for the Cherokee web server
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.
[^1]: Images pulled from GitHub Packages will be more up-to-date as they will be built more frequently than those on Docker Hub.