https://github.com/unknown-gd/quakejs-dockerized-ssl
Fully dockerized version of the QuakeJS project.
https://github.com/unknown-gd/quakejs-dockerized-ssl
docker docker-compose docker-container js quake3 ssl web
Last synced: about 2 months ago
JSON representation
Fully dockerized version of the QuakeJS project.
- Host: GitHub
- URL: https://github.com/unknown-gd/quakejs-dockerized-ssl
- Owner: unknown-gd
- License: mit
- Created: 2025-02-18T19:40:52.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-19T12:30:40.000Z (about 1 year ago)
- Last Synced: 2025-10-10T05:15:14.602Z (9 months ago)
- Topics: docker, docker-compose, docker-container, js, quake3, ssl, web
- Language: Shell
- Homepage:
- Size: 22.5 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Q3JS - Fully dockerized
Fully dockerized version of the [QuakeJS](https://github.com/unknown-gd/quakejs) project.
## Used Ports
* `27961-27964` - QuakeJS dedicated server's
* `27950` - QuakeJS master server
* `9000` - QuakeJS content server
* `443` - QuakeJS web client
## Pre-requisites
### Docker Engine & Compose Plugin
```bash
apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
```
### Libarchive-zip-perl and zipmerge ( Optional )
Required for `cctools`, used to merge .pk3 files.
```bash
apt-get install -y libarchive-zip-perl zipmerge
```
## How to start?
1. Set your domain name into `.env` as `Q3JS_DOMAIN`
2. Change paths to your certificate and key in `certificates/config.json`
3. Run `docker compose build && docker compose up -d`
## How to stop?
Lol, just run `docker compose down`
## How to configure?
* `.env` - General configuration
* `config/certificates` - SSL configuration
* `config/dedicated-server` - Dedicated server configuration ( `baseq3` and `cpma` gamemodes )
* `index.ejs` - Web client configuration
#### Also check out:
* [Quake 3 - Console variables](http://www.joz3d.net/html/q3console.html)
* [Official Wiki](https://steamforge.net/wiki/index.php/How_to_setup_a_local_QuakeJS_server_under_Debian_9_or_Debian_10)
## How I can make clients connect to my server automatically?
Just uncomment the line `args.push.apply( args, [ "+connect", "q3js.changeme.com:27961" ] )` in `index.ejs`
## How to use `cctools`? ( Repack and merge .pk3 files )
[README.md](./cctools/README.md) [ `LF` ONLY ]