Run Headlamp with a base-url

    Normally Headlamp runs at the root of the domain. Hower you can also ask to run it at a base-url like “/headlamp” for example.

    • default at the root of the domain:
    • base-url

    A warning about multiple apps on the same sub domain

    Hosting multiple websites (apps) on the same origin can lead to possible conflicts between the apps. Each app is able to access information and make requests of the other. Therefore each app needs to be tested together, trusted, and a compatible Content-Security-Policy should be considered for each of them.

    If in doubt, host Headlamp on a separate origin (domain or port, don’t use the -base-url option).

    How to use with a base-url

    Dev mode

    ./backend/headlamp-server -dev -base-url /headlamp
    PUBLIC_URL="/headlamp" make run-frontend

    Then go to http://localhost:3000/headlamp/ in your browser.

    Static build mode

    cd frontend && npm install && npm run build && cd ..
    ./backend/headlamp-server -dev -base-url /headlamp -html-static-dir frontend/build

    Then go to http://localhost:4466/headlamp/ in your browser.

    Docker mode

    Append --base-url /headlamp to the docker run command. Note the extra “-”.


    You can modify your kubernetes deployment file to add -base-url /headlamp to the containers args.

              - "-in-cluster"
              - "-plugins-dir=/headlamp/plugins"
              - "-base-url=/headlamp"