Homarr•4d ago

Run on different port

I'm running Homarr in Docker using ipvlan networking, which prevents me from using the standard port mapping functionality (like -p 80:7575). I want to change the default port that Homarr runs on internally from 7575 to 80, as my network configuration doesn't allow port mapping. I've tried setting DOCKER_PORTS=80 as an environment variable, but this doesn't change Homarr's listening port (it only affects Docker API connectivity) [according to the ai]. Is there any way to configure Homarr to listen on a different port than the default 7575? Perhaps through an environment variable or configuration file that isn't mentioned in the documentation? Or am I not using an obvious docker feature?

checked another question, PORT env did not work either

Port 7575 seems hardcoded

Mapping port 80:7575 - Homarr

I have a goal of reaching my dashboard via dashboard.mydomain.com from within my LAN. Using portainer, I've configured and created a macvlan and updated the Homarr stack to use that network. The container is now happily running on its own reserved IP at 192.168.1.160 and I'm able to reach the dashboard at http://homarr.mydomain.com:7575. The n...

Solution:

We can set the port by overriding the NGINX config at /etc/nginx/templates/nginx.conf with a bind volume like below (docker compose). ```yml volumes: - ./HOMARRNGINX.conf:/etc/nginx/templates/nginx.conf networks:...

Jump to solution

5 Replies

Cakey Bot•4d ago

Thank you for submitting a support request. Depending on the volume of requests, our team should get in contact with you shortly.

⚠️ Please include the following details in your post or we may reject your request without further comment: - Log (See https://homarr.dev/docs/community/faq#how-do-i-open-the-console--log) - Operating system (Unraid, TrueNAS, Ubuntu, ...) - Exact Homarr version (eg. 0.15.0, not latest) - Configuration (eg. docker-compose, screenshot or similar. Use ``your-text`` to format) - Other relevant information (eg. your devices, your browser, ...)

Frequently Asked Questions | Homarr documentation

Can I install Homarr on a Raspberry Pi?

FloyddoOP•4d ago

homarr:
    container_name: homarr
    image: ghcr.io/homarr-labs/homarr:latest
    restart: unless-stopped
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock 
      - ${USERDIR}/docker/homarr/appdata:/appdata
      - /etc/localtime:/etc/localtime:ro
      - /usr/share/zoneinfo:/usr/share/zoneinfo:ro
    environment:
      - TZ=${TZ}
      - SECRET_ENCRYPTION_KEY=${HOMARR_KEY} # <--- can be generated with `openssl rand -hex 32`
      - PORT=80
    networks:
      comm:
      lan:
        ipv4_address: 192.168.1.29

homarr:
    container_name: homarr
    image: ghcr.io/homarr-labs/homarr:latest
    restart: unless-stopped
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock 
      - ${USERDIR}/docker/homarr/appdata:/appdata
      - /etc/localtime:/etc/localtime:ro
      - /usr/share/zoneinfo:/usr/share/zoneinfo:ro
    environment:
      - TZ=${TZ}
      - SECRET_ENCRYPTION_KEY=${HOMARR_KEY} # <--- can be generated with `openssl rand -hex 32`
      - PORT=80
    networks:
      comm:
      lan:
        ipv4_address: 192.168.1.29

Version 1.12.0

FloyddoOP•4d ago

homarr uses nginx as a reverse proxy to serve the next.js page and is hardcoded to be listening at port 7575 https://github.com/homarr-labs/homarr/blob/ac77bdd84cba47a43d1952725a9c7feccd972766/nginx.conf#L4

GitHub

homarr/nginx.conf at ac77bdd84cba47a43d1952725a9c7feccd972766 · ho...

A modern and easy to use dashboard. 14+ integrations. 10K+ icons built in. Authentication out of the box. No YAML, drag and drop configuration. - homarr-labs/homarr

Solution

Floyddo•4d ago

We can set the port by overriding the NGINX config at /etc/nginx/templates/nginx.conf with a bind volume like below (docker compose).

    volumes:
      - ./HOMARRNGINX.conf:/etc/nginx/templates/nginx.conf
    networks:
      lan: # your ipvlan or macvlan network

    volumes:
      - ./HOMARRNGINX.conf:/etc/nginx/templates/nginx.conf
    networks:
      lan: # your ipvlan or macvlan network

./HOMARRNGINX.conf: (just change the port from this file, keep in mind this will not upgrade this file with updates at it will just keep overriding it!)

events {
    worker_connections 1024;
}

http {
    server {
        listen YOURPORTHERE;

        # Route websockets traffic to port 3001
        location /websockets {
            proxy_pass http://${HOSTNAME}:3001;
            proxy_http_version 1.1;
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection "Upgrade";
            proxy_set_header Host $http_host;
        }

        # Route all other traffic to port 3000
        location / {
            proxy_pass http://${HOSTNAME}:3000;
            proxy_set_header Host $http_host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $http_x_forwarded_proto;
        }
    }
}

events {
    worker_connections 1024;
}

http {
    server {
        listen YOURPORTHERE;

        # Route websockets traffic to port 3001
        location /websockets {
            proxy_pass http://${HOSTNAME}:3001;
            proxy_http_version 1.1;
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection "Upgrade";
            proxy_set_header Host $http_host;
        }

        # Route all other traffic to port 3000
        location / {
            proxy_pass http://${HOSTNAME}:3000;
            proxy_set_header Host $http_host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $http_x_forwarded_proto;
        }
    }
}

Manicraft1001•3d ago

Please note that doing this is officially unsupported, meaning that this could break your setup anytime. Always prefer virtual networks (such as docker) by default.

Gaming

Programming

Run on different port

Did you find this page helpful?