Made it possible to change the port via the ENV Variable CWA_PORT_OVERRIDE. Default port is still 8083. External port now defaults to override port if given

Author: crocodilestick

CONTRIBUTORS

@@ -1,7 +1,7 @@
 CONTRIBUTORS
 
 This file is automatically generated. DO NOT EDIT MANUALLY.
-Generated on: 2025-08-25T17:44:28.444765Z
+Generated on: 2025-08-25T19:21:37.195194Z
 
 Upstream project: https://github.com/janeczku/calibre-web
 Fork project (Calibre-Web Automated, since 2024): https://github.com/crocodilestick/calibre-web-automated
@@ -289,7 +289,7 @@ Copyright (C) 2024-2025 Calibre-Web Automated contributors
 - zhiyue (1 commits)
 # Fork Contributors (crocodilestick/calibre-web-automated)
 
-- crocodilestick (564 commits)
+- crocodilestick (567 commits)
 - jmarmstrong1207 (73 commits)
 - demitrix (30 commits)
 - sirwolfgang (22 commits)

Dockerfile

@@ -191,6 +191,7 @@ ENV CALIBRE_CONFIG_DIR=/config/.config/calibre
 
 # ports and volumes
 WORKDIR /config
+# The default port CWA listens on. Can be overridden with the CWA_PORT_OVERRIDE environment variable.
 EXPOSE 8083
 VOLUME /config
 VOLUME /cwa-book-ingest

README.md

@@ -288,6 +288,9 @@ services:
       # If your library is on a network share (e.g., NFS/SMB), disable WAL to reduce locking issues
       # Accepts: true/false (default: false)
       - NETWORK_SHARE_MODE=false
+      # Override the default port (8083) for the web server.
+      # Accepts any valid port number.
+      - CWA_PORT_OVERRIDE=8083
     volumes:
       # CW users migrating should stop their existing CW instance, make a copy of the config folder, and bind that here to carry over all of their user settings ect.
       - /path/to/config/folder:/config 

cps/admin.py

@@ -1812,7 +1812,6 @@ def _configuration_update_helper():
     reboot_required = False
     to_save = request.form.to_dict()
     try:
-        reboot_required |= _config_int(to_save, "config_port")
         reboot_required |= _config_string(to_save, "config_trustedhosts")
         reboot_required |= _config_string(to_save, "config_keyfile")
         if config.config_keyfile and not os.path.isfile(config.config_keyfile):

cps/config_sql.py

@@ -62,7 +62,6 @@ class _Settings(_Base):
     config_calibre_uuid = Column(String)
     config_calibre_split = Column(Boolean, default=False)
     config_calibre_split_dir = Column(String)
-    config_port = Column(Integer, default=constants.DEFAULT_PORT)
     config_external_port = Column(Integer, default=constants.DEFAULT_PORT)
     config_certfile = Column(String)
     config_keyfile = Column(String)

cps/constants.py

@@ -127,12 +127,13 @@
 
 DEFAULT_PASSWORD    = "admin123"  # nosec
 DEFAULT_PORT        = 8083
-env_CALIBRE_PORT = os.environ.get("CALIBRE_PORT", DEFAULT_PORT)
-try:
-    DEFAULT_PORT = int(env_CALIBRE_PORT)
-except ValueError:
-    print('Environment variable CALIBRE_PORT has invalid value (%s), faling back to default (8083)' % env_CALIBRE_PORT)
-del env_CALIBRE_PORT
+env_CWA_PORT_OVERRIDE = os.environ.get("CWA_PORT_OVERRIDE")
+if env_CWA_PORT_OVERRIDE:
+    try:
+        DEFAULT_PORT = int(env_CWA_PORT_OVERRIDE)
+    except (ValueError, TypeError):
+        print(f"Environment variable CWA_PORT_OVERRIDE has invalid value ('{env_CWA_PORT_OVERRIDE}'), falling back to default (8083)")
+        DEFAULT_PORT = 8083
 
 
 EXTENSIONS_AUDIO = {'mp3', 'mp4', 'ogg', 'opus', 'wav', 'flac', 'm4a', 'm4b'}

cps/server.py

@@ -30,7 +30,7 @@
     VERSION = 'Tornado ' + _version
     _GEVENT = False
 
-from . import logger
+from . import logger, constants
 
 
 log = logger.create()
@@ -60,7 +60,7 @@ def __init__(self):
     def init_app(self, application, config):
         self.app = application
         self.listen_address = config.get_config_ipaddress()
-        self.listen_port = config.config_port
+        self.listen_port = constants.DEFAULT_PORT
 
         if config.config_access_log:
             log_name = "gevent.access" if _GEVENT else "tornado.access"

cps/templates/admin.html

@@ -118,9 +118,9 @@ <h2>{{_('Configuration&nbsp;&nbsp;⚙️')}}</h2>
         </div>
         <div class="row">
             <div class="col-xs-6 col-sm-6">{{_('Port')}}</div>
-            <div class="col-xs-6 col-sm-6">{{config.config_port}}</div>
+            <div class="col-xs-6 col-sm-6">{{config.config_external_port}}</div>
         </div>
-        {% if kobo_support and config.config_port != config.config_external_port %}
+        {% if kobo_support and config.config_external_port != config.config_external_port %}
         <div class="row">
           <div class="col-xs-6 col-sm-6">{{_('External Port')}}</div>
           <div class="col-xs-6 col-sm-6">{{config.config_external_port}}</div>

cps/templates/config_edit.html

@@ -21,10 +21,10 @@ <h4 class="panel-title">
     </div>
     <div id="collapseone" class="panel-collapse collapse">
       <div class="panel-body">
-        <div class="form-group">
+        <!-- <div class="form-group">
           <label for="config_port">{{_('Server Port')}}</label>
           <input type="number" min="1" max="65535" class="form-control" name="config_port" id="config_port" value="{% if config.config_port != None %}{{ config.config_port }}{% endif %}" autocomplete="off" required>
-        </div>
+        </div> -->
         <label for="config_certfile">{{_('SSL certfile location (leave it empty for non-SSL Servers)')}}</label>
          <div class="form-group input-group">
           <input type="text" class="form-control" id="config_certfile" name="config_certfile" value="{% if config.config_certfile != None %}{{ config.config_certfile }}{% endif %}" autocomplete="off">

docker-compose.yml

@@ -9,6 +9,8 @@ services:
       - PGID=1000
       # Edit to match your current timezone https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
       - TZ=UTC
+      # Sets the listening port for the application. Defaults to 8083.
+      # - CWA_PORT_OVERRIDE=8083
       # Hardcover API Key required for Hardcover as a Metadata Provider, get one here: https://docs.hardcover.app/api/getting-started/
       - HARDCOVER_TOKEN=your_hardcover_api_key_here
       # If your library is on a network share (e.g., NFS/SMB), disables WAL and chown to reduce locking/permission issues,