Skip to content

feat: allow configuring internal port via CONVERTX_PORT#564

Closed
upmcplanetracker wants to merge 1 commit into
C4illin:mainfrom
upmcplanetracker:main
Closed

feat: allow configuring internal port via CONVERTX_PORT#564
upmcplanetracker wants to merge 1 commit into
C4illin:mainfrom
upmcplanetracker:main

Conversation

@upmcplanetracker

@upmcplanetracker upmcplanetracker commented Jun 9, 2026

Copy link
Copy Markdown

Update index.tsx for feat: allow configuring internal port via CONVERTX_PORT

Description

This PR updates the server initialization line to check for a dedicated CONVERTX_PORT environment variable before falling back to PORT or the default 3000.

Motivation

While ConvertX already supports the generic PORT environment variable, adding a container-specific variable (CONVERTX_PORT) provides distinct advantages for advanced homelab deployments:

  1. Host Networking Layering (network_mode: host): Essential for deployments where using a generic PORT variable can cause unintended environment leakage or conflicts across multiple containers sharing the host network namespace.
  2. Explicit Configuration: Makes docker-compose files and Podman Quadlets much easier to read and maintain by keeping environment variables distinct to their specific applications.

Backward Compatibility

This change utilizes a standard fallback chain (process.env.CONVERTX_PORT || process.env.PORT || 3000). If neither variable is set, the application continues to default to 3000. Existing installations and deployments relying on the generic PORT variable will experience zero breaking changes.


Summary by cubic

Allow configuring the server’s internal port via CONVERTX_PORT, falling back to PORT and then 3000. This improves container deployments with explicit app ports while keeping full backward compatibility (CONVERTX_PORT -> PORT -> 3000).

Written for commit c18c800. Summary will update on new commits.

Review in cubic

…TX_PORT

### Description
This PR updates the server initialization line to check for a dedicated `CONVERTX_PORT` environment variable before falling back to `PORT` or the default `3000`.

### Motivation
While ConvertX already supports the generic `PORT` environment variable, adding a container-specific variable (`CONVERTX_PORT`) provides distinct advantages for advanced homelab deployments:
1. **Host Networking Layering (`network_mode: host`):** Essential for deployments where using a generic `PORT` variable can cause unintended environment leakage or conflicts across multiple containers sharing the host network namespace.
2. **Explicit Configuration:** Makes docker-compose files and Podman Quadlets much easier to read and maintain by keeping environment variables distinct to their specific applications.

### Backward Compatibility
This change utilizes a standard fallback chain (`process.env.CONVERTX_PORT || process.env.PORT || 3000`). If neither variable is set, the application continues to default to `3000`. Existing installations and deployments relying on the generic `PORT` variable will experience zero breaking changes.
@github-actions github-actions Bot added Feature and removed Feature labels Jun 9, 2026

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 1 file

Re-trigger cubic

@upmcplanetracker upmcplanetracker closed this by deleting the head repository Jun 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant