Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

iTechGuides is reader-supported. When you buy through links on our site, we may earn an affiliate commission. As an Amazon Associate I earn from qualifying purchases. Learn more

Start the dashboard on a different port with hermes dashboard --port <number>. Hermes Agent uses port 9119 by default, so hermes dashboard --port 8080 starts it on 8080 for that run. In Docker, set HERMES_DASHBOARD_PORT and publish the same port from the host to the container. Changing the port does not disable authentication: current documentation says --insecure is a no-op, and any bind address other than 127.0.0.1 requires a password or OAuth provider.

Choose the method that matches your installation

Hermes Agent exposes its web dashboard in two common ways. A direct CLI launch uses a command-line flag; a Docker deployment uses an environment variable plus Docker port publishing. The setting is not interchangeable between those methods.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Deployment Setting Default How long it applies Important detail
CLI --port <number> 9119 That dashboard launch Run the flag every time unless your own launcher repeats it.
Docker HERMES_DASHBOARD_PORT plus -p 9119 That container configuration Publish the host and container ports consistently when you change the value.

The current documentation identifies 9119 as the web-server default. A port number is only one part of reachability: the process must listen on that port, and Docker or another network layer must forward traffic to it.

Change the port when running Hermes Agent from the CLI

1. Stop the existing dashboard

If a dashboard is already running, stop that process before starting another one. Otherwise, you can mistake the old listener on 9119 for a failed port change, or receive an “address already in use” error if both launches target the same port.

#1 Best Overall
Sale
Compressed Air Duster,130000RPM Super Power Cordless Air Duster,Rechargeable Brushless Blower,3 Gear Adjustable Blower with LED Light,Dust Remover for Computer/House/Outdoor/Car
  • Powerful Turbo Fan:CAGIWIRU Electric Air Duster have reached speed up to 130000RPM,Can efficient remove dust and debris.With LED light and Three Adjustable Speed to meet with different cleaning tasks.
  • With Attached USB C Fasting Charging cable.Charing 3 hours,Enjoy up to 240 minutes of use on the lowest setting, For third speed can use for 25mins.with four charging options to meet with your needs.
  • Wide Application:Upgraded attached 5 different nozzles,making it suitable for a variety of scenes, such as car,pet, pc, keyboards, and other electronic devices. It also serves for office and home clean duster.
  • Handy Design & Portable:Cordless air duster electric nozzle is Light weight and small size, design and comfortable to hold and space saving, convenient to carry around. You can put it in your room or inside the car without taking up space.
  • Warranty & Support: Our Electric air duster comes with 5 years warranty and 24/7 customer service. During this period, if you have any questions,pls kindly feel free to contact us.

2. Add the --port flag

Use the documented command form:

hermes dashboard --port <number>

For example, to use port 8080:

hermes dashboard --port 8080

Replace <number> with the numeric port you intend to use. The flag belongs on the dashboard subcommand; do not place it before hermes or substitute a Docker variable in a CLI launch.

3. Open the dashboard on the new port

Use the same host or address you normally use, but replace 9119 with the selected port. For a local dashboard, that means the URL whose port component is your new value rather than 9119. If you are accessing it through a reverse proxy or another forwarding layer, update that layer to target the new listener as well.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

4. Confirm the listener before troubleshooting the browser

A successful launch should leave the Hermes web server listening on the requested port. If the browser cannot connect, first verify that the dashboard process is still running and that the URL contains the new number. Then check whether another service owns the port, whether a firewall or proxy still points at 9119, and whether you accidentally started a second dashboard with the default command.

What happens if port 9119 is already busy?

Port 9119 is the default, not a mandatory value. Choose another unused port and pass it explicitly. A third-party guide uses --port 9120 as an example for a busy 9119, but that number is not an official requirement or a universal replacement.

Rank #2
EVEO® Screen Cleaner Spray Kit (Streak-Free) TV Screen Cleaner for Smart TV, Lcd, LEd, Oled | Computer Screen Cleaner Spray and Wipe Microfiber Cloth - TV, Monitor, Laptop, iPad, Car - 6.7oz 1 Pack
  • Screen Cleaner is Your Screen’s New Bestfriend! - EVEO is proud to present a screen cleaner that’s perfectly suited for your TV. Meet your new screen cleaner, computer screen cleaner, laptop cleaner, iPad cleaner, Macbook,tv cleaner or any other electronic device. Our screen cleaner spray and wipe along with the included plush microfiber cloth, easily removes dust, fingerprints & other smudges on the screen’s surface. Clean effectively for a streak-free screen
  • Gentle on your Screens - Our screen cleaner spray and wipes is compatible to be used even for the most sensitive LCD, LED, CRT, and OLED screens in proper use. Be at ease knowing that this product is compatible with all the major brands: LG, SONY, Samsung, Sharp, iPad, iPhone, Android screens, Kindle, PC monitors - we’ve got you covered! Can be used as LCD screen cleaner, tv cleaner, smart tv screen cleaner, and more
  • Premium Super Soft Plush Microfiber Cloth - Included in this efficient screen cleaning kit. This screen cleaner spray and wipe has our signature plush microfiber cloth specially designed to comply with screens and monitors and leave them streak-free. Has been shown to effectively absorbs stubborn stains, zero streaks, and no fiber shedding. Always use this together with our screen cleaner for the best results
  • Easy-to-Use Screen Cleaner Kit + microfiber cleaning cloth - The EVEO Screen Cleaning Kit will easily be your new favorite tool when it comes to taking care of the things you love most, quick and easy solution for a streak-free screen. Simply screw on the sprayer gun on the screen cleaner bottle. Spray the cleaning liquid onto the microfiber cloth, then wipe the screen until desired cleanliness & shine is achieved.
  • Quality Screen Care Kit Worth Purchasing - Enjoy a convenient Screen Cleaner anytime, anywhere you need it. Your satisfaction is our top priority. We stand behind the quality of our products and that’s why, you shouldn’t be worrying at all. We manufacture the Best Screen Cleaner. and can be used for laptop cleaning kit, laptop screen cleaner, tv screen cleaner for smart tv. MacBook screen cleaner, monitor cleaner or screen cleaner spray for electronic devices with microfiber cleaning cloth
  1. Identify a port that is not occupied by another service in the environment where Hermes runs.
  2. Start Hermes with the chosen value, such as hermes dashboard --port 9120.
  3. Change the address used by your browser, proxy, firewall rule, or tunnel to the same value.
  4. If the port is still reported as busy, stop the process currently listening there or select a different unused value.

Do not infer that a successful process start means the dashboard is reachable from every network. Listening locally and being exposed publicly are separate decisions.

Change the port in Docker

Set HERMES_DASHBOARD_PORT

Docker deployments use the HERMES_DASHBOARD_PORT environment variable. The documented default is 9119. Set the variable to the port on which the Hermes dashboard should listen inside the container.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The container configuration must also publish that port. Documentation examples publish the default with:

-p 9119:9119

When you change the dashboard port, change the published mapping to match the new value. Conceptually, a move to 8080 requires both the environment setting and a mapping equivalent to -p 8080:8080. Keep the host and container sides aligned for the Hermes configuration you selected.

Rank #3
BladeHawks RGB Gaming Mouse Pad Extra Large Extended 31.5x12 Inch-Black
  • 【Large size】:Measuring 800 x 300 mm/ 31. 5×12 inches, which is wider and taller than others. Large mouse pad can perfectly fit your keyboard and mouse of any size, and there is also ample space for peripherals such as phones, tablets, etc.
  • 【LED backlight mouse pad】:Blade Hawks RGB mouse pad provides 7 static modes and 7 dynamic modes will give you the options you are looking for. Power-off memory function remembers the last lighting mode you selected. The super glow fiber Chroma will give you a colorful gaming setup that you want.
  • 【Anti-slip rubber base】:Made from Natural rubber, this gaming mousepad will firmly grip your desktop, allowing you to enjoy the ultimate precision in the games you are most passionate about. It also comes with a texture that enhances this ability even further.
  • 【Smooth and waterproof surface】: Micro-textured cloth surface, for extremely precise mouse control and a smooth movement. When liquid splashes on the gaming mouse pad, it forms water droplets and slides down. Will not delay your work or gameplay.
  • 【Plug and play】: This mouse and keyboard pad is powered by USB, plug and play, no driver required. One button control light modes. Press one time to change the lighting mode, press twice to change the brightness, press and hold about 3 seconds turn ON/OFF.

Example Docker launch pattern

A complete launch contains three pieces: the image and normal Hermes arguments used by your deployment, the environment variable, and the port publication. The relevant fragments look like this:

HERMES_DASHBOARD_PORT=8080
-p 8080:8080

Add those fragments using the syntax of your existing Docker command or Compose configuration. The exact image name, volumes, credentials, and other application options are deployment-specific and are not changed by the port setting.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Verify both sides of the mapping

If the container listens on 8080 but Docker still publishes 9119, requests sent to 9119 will not reach the newly configured listener in the way you expect. Conversely, publishing a host port without changing Hermes’ internal port leaves the application listening somewhere else. Check the environment value, the container’s listening port, and the host-to-container publication as one set.

CLI flag versus Docker variable

Question CLI launch Docker deployment
What do I change? --port <number> HERMES_DASHBOARD_PORT and Docker -p publication
Default 9119 9119
Scope The process started with that command The container created with that environment and publication
What must the browser use? The CLI-selected port The published host port
What commonly gets missed? Reusing an old launcher that omits the flag Changing the variable but leaving -p 9119:9119

A flag typed at launch is per-run. Current documentation does not establish a Hermes-specific configuration-file or systemd setting that permanently stores the port. If a service manager, script, or Compose file starts Hermes for you, edit that launcher so it supplies the same value on every restart; do not assume that one manual launch changes future launches.

Rank #4
Sale
Vaydeer Wrist Rest for Keyboard and Mouse, Computer Ergonomic Wrist Support Pad, Soft Memory Foam Arm Cushion for Desk, Palm Hand Office Laptop Typing
  • 【Softer and More Comfortable】Vaydeer wrist rest has unique diamond pattern, which is the combination of softness and aesthetics. The materials of wrist rest are improved into higher quality memory foam and covered with silky smooth lycra. The computer wrist rest makes you as comfortable and cushiony as like rest your wrists on clouds.
  • 【Ergonomic Wrist Saver】The wrist rests for keyboard and mouse comes with a 17.32×3.15×0.83 inch keyboard wrist pad and a 5.94×3.15×0.83 inch mouse wrist support. Based on ergonomic design, the unique concave shape is the perfect fit for your wrist joints. The wrist rest pad fits most computer keyboards and laptops, improve hand and wrist posture, release your wrist and arm stress.
  • 【Non-Slip Rubber Bottom】Featuring an anti-skid silicone base on the bottom, this wrist keyboard support stays firmly in place on your desk, preventing the padding from sliding around, ensuring stable and consistent wrist support during extended computer sessions.
  • 【Better Experience & Pain Relief】Our keyboard arm rest is beneficial to alleviate the soreness caused by direct contact and friction between your arm and a hard desk surface, reducing the risk of wrist fatigue or carpal tunnel. The soft texture of memory foam can evenly distribute the pressure around your wrists and provide good support with just enough give.
  • 【Helpful in Multiple Scenarios】Whether you're working, studying, writing, typing, gaming, this keyboard and mouse rest combo is an essential accessory to add comfort and support to your hands and wrists. It’s also a great gift for men, women, family, friend, coworker, gamer, teacher, etc.

Authentication and network exposure after a port change

Changing the port does not turn security off

Older third-party instructions may tell you to add --insecure when the dashboard is not bound to localhost. Current official documentation says that --insecure is a no-op and does not disable authentication. Do not add it merely because you changed the port or because the dashboard is reachable on another interface.

Localhost versus a public bind

The security boundary is the bind address, not the port number. A service bound to 127.0.0.1 is limited to the local machine. A public bind means any bind address other than 127.0.0.1; current documentation requires an authentication provider for that case. Configure a password or OAuth provider before exposing the dashboard beyond localhost.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  • Local-only use: keep the dashboard on a localhost bind and connect from the same machine.
  • Remote use: arrange the required password or OAuth authentication, then expose the selected port through only the network path you intend.
  • Port change: update firewall, proxy, tunnel, and access-control rules to the new port without weakening authentication.

The June 2026 hardening guidance is why advice that treats --insecure as mandatory is outdated. A different port is not a substitute for authentication, encryption, or network restriction.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

How to diagnose a failed port change

The command rejects the option

Check that you used the current spelling, --port, after hermes dashboard. Do not use a similarly named option copied from an older guide. Verify the installed Hermes version’s help output and current documentation if the command still reports an unknown option, because documentation and the software can change.

Best Value
Sale
Under Desk Cable Management Tray No Drill, Metal Mesh Cable Management Under Desk with Clamp Mount, 2 Hole Cable Tray with Wire Management and Cord Organizer for Home Office Standing Desk
  • 【No Drill Mounted】Cable management tray can be assembled in as little as 3 minutes or less-simply. Side clips easily clampe the edge of desk, pass through the holes on the sides, and secure excess cables with baskets. Desk cable management supports inward or outward installation to meet your needs in different scenarios, and provides you with great convenience when collecting and organizing wires.
  • 【Rubber Pad Protects Desk】Wire organizer under desk built-in soft rubber pads on the clamp protect your desk from scratches, so you will not damage your furniture or office.
  • 【Sturdy and Beautiful】Cord management under desk is made of high-quality carbon steel and holds about 15 lbs. The wire basket has 2 holes on each side of the tray to enable your cables to pass freely. Cable baskets are suitable for desk thickness use from 0.4" to 2.4".
  • 【Space Saving & Keep Organized】Desk cable management tray holds all your power cords, outlet strips, USB hubs and computer transformers hidden from your feet, and the data cables will not enter the vacuum cleaner to keep your desk clean and tidy. Desk wire organizer is also suitable for use in the kitchen and outdoors.
  • 【Reduce Safety Risks】Cable tray under desk keeps all plugs away from your kids, no more worry about tripping. Using 2 holes wire tray saves extra space, helps you easily cabling and wire protection. The mesh design is not easy to accumulate dust, but avoids safety accidents caused by messy wires.

The launch says the address is already in use

Another process is listening on the selected number, or an earlier Hermes instance is still running. Stop the conflicting process if it is yours, or choose another unused port. The documented CLI form remains the same; 9120 is only an example, not a guaranteed free port.

The browser still opens the old dashboard

You may be connecting to a process that is still listening on 9119. Stop the old instance, confirm the new command actually started, and replace the port in the browser address. In Docker, inspect the published mapping rather than relying only on the environment variable.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The browser cannot connect after a Docker change

  • Confirm HERMES_DASHBOARD_PORT contains the intended number.
  • Confirm the container was recreated or restarted with that environment value; editing a file without recreating the container does not alter an already running process.
  • Confirm Docker publishes the same host and container port, such as the equivalent of -p 8080:8080 for an 8080 configuration.
  • Use the published host port in the browser, not an internal-only container port.

Remote access fails while local access works

That symptom points to binding, authentication, or network policy rather than the numeric port alone. Check whether Hermes is bound to 127.0.0.1, whether your proxy or firewall forwards the new port, and whether the required password or OAuth provider is configured for a non-local bind. Do not try to solve an authentication failure with --insecure; current documentation says it has no effect.

A restart returns to 9119

The port flag is per-run, and the Docker variable applies to the container configuration that includes it. Find the command, service definition, script, or Compose configuration that performs the restart and add the same setting there. Hermes’ current documentation does not verify a separate configuration-file or systemd persistence mechanism, so avoid assuming that an undocumented file will be read.

Safe change procedure

  1. Record the current deployment: determine whether Hermes is launched directly or in Docker, and note the current bind address and any proxy or firewall in front of it.
  2. Select an unused port: retain 9119 if it is available, or choose another number such as the 9120 example when you have confirmed it is free.
  3. Apply the correct setting: use hermes dashboard --port <number> for CLI, or set HERMES_DASHBOARD_PORT and matching Docker publication for a container.
  4. Restart the actual launcher: stop the old process or recreate the container so only the intended listener remains.
  5. Update access paths: change the browser URL and any proxy, firewall, tunnel, health check, or documentation that still names 9119.
  6. Test locally first: confirm the dashboard responds on the new port from the machine running Hermes.
  7. Test remote access only when needed: verify the bind and authentication requirements before allowing connections from other hosts.
  8. Make the setting repeatable: place the flag or environment variable in the launcher that performs future starts, while recognizing that the official documentation does not specify a universal persistence file.

Port-change checklist

  • The CLI uses --port, not a different option name.
  • 9119 is the documented default.
  • Docker uses HERMES_DASHBOARD_PORT.
  • Docker’s published host and container ports match the selected Hermes port in the documented pattern.
  • The browser, proxy, firewall, and tunnel all use the new externally reachable port.
  • No older Hermes process is still serving the default port.
  • A non-127.0.0.1 bind has a password or OAuth provider configured.
  • --insecure has not been added on the assumption that it disables authentication; current docs describe it as a no-op.
  • The recurring launcher contains the setting, because a one-time CLI flag does not automatically persist.

What the port setting does—and does not—change

The setting chooses the TCP port where the Hermes web server listens. It does not, by itself, change the bind address, create authentication credentials, configure TLS, open a firewall, update a reverse proxy, or make a Docker container reachable from the host. Those layers must be configured separately according to your deployment.

For a local CLI session, the smallest change is therefore one flag: hermes dashboard --port 8080. For Docker, the smallest reliable change is a coordinated pair: set HERMES_DASHBOARD_PORT and publish the corresponding port. In both cases, keep authentication enabled whenever the dashboard is exposed beyond localhost.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.