[GH-ISSUE #3770] frpc config reload fails saying it requires web server port

gitea-mirror commented

2026-05-05 13:56:09 -06:00

Owner

Originally created by @rbose21 on GitHub (Nov 14, 2023).
Original GitHub issue: https://github.com/fatedier/frp/issues/3770

Bug Description

I have an frpc client running fine, but if I update its config file and try to hot reload, the command fails. See below:

~# /usr/local/bin/frpc reload -c .~/frpc.toml
web server port should be set if you want to use this feature

If I dont use reload everything works fine. I want to reload the frpc config with updated changes without stopping the client. Not sure why it requires the web-server and I can see that if I add the webServer.Port to frpc config, it tries to call the API http://127.0.0.1:7500/api/reload so it might be getting confused with the dashboard reload.

frpc Version

0.52.3

frps Version

0.52.3

System Architecture

linux/amd64

Configurations

frpc config is:

serverAddr = "x.x.x.x"
serverPort = xxxx
auth.method = "token"
auth.token = "xxxxxxxx"
log.to = "/frpc.log"
log.level = "debug"
log.maxDays = 3
includes = ["/confd/*.toml"]

Logs

No response

Steps to reproduce

Create a simple frpc/frps service ( e.g. just use the examples)
Run /usr/local/bin/frpc reload -c ./frpc.toml

Affected area

Docs
Installation
Performance and Scalability
Security
User Experience
Test and Release
Developer Infrastructure
Client Plugin
Server Plugin
Extensions
Others

Originally created by @rbose21 on GitHub (Nov 14, 2023). Original GitHub issue: https://github.com/fatedier/frp/issues/3770 ### Bug Description I have an frpc client running fine, but if I update its config file and try to hot reload, the command fails. See below: ``` ~# /usr/local/bin/frpc reload -c .~/frpc.toml web server port should be set if you want to use this feature ``` If I dont use reload everything works fine. I want to reload the frpc config with updated changes without stopping the client. Not sure why it requires the web-server and I can see that if I add the webServer.Port to frpc config, it tries to call the API `http://127.0.0.1:7500/api/reload` so it might be getting confused with the dashboard reload. ### frpc Version 0.52.3 ### frps Version 0.52.3 ### System Architecture linux/amd64 ### Configurations frpc config is: serverAddr = "x.x.x.x" serverPort = xxxx auth.method = "token" auth.token = "xxxxxxxx" log.to = "/frpc.log" log.level = "debug" log.maxDays = 3 includes = ["/confd/*.toml"] ### Logs _No response_ ### Steps to reproduce 1. Create a simple frpc/frps service ( e.g. just use the examples) 2. Run /usr/local/bin/frpc reload -c ./frpc.toml ### Affected area - [ ] Docs - [ ] Installation - [ ] Performance and Scalability - [ ] Security - [ ] User Experience - [ ] Test and Release - [ ] Developer Infrastructure - [ ] Client Plugin - [ ] Server Plugin - [ ] Extensions - [ ] Others

gitea-mirror

2026-05-05 13:56:09 -06:00

closed this issue
added the
lifecycle/stale
label

gitea-mirror commented

2026-05-05 13:56:12 -06:00

Author

Owner

@superzjg commented on GitHub (Nov 14, 2023):

https://github.com/fatedier/frp/blob/dev/README.md#hot-reloading-frpc-configuration

@superzjg commented on GitHub (Nov 14, 2023): https://github.com/fatedier/frp/blob/dev/README.md#hot-reloading-frpc-configuration

gitea-mirror commented

2026-05-05 13:56:13 -06:00

Author

Owner

@rbose21 commented on GitHub (Nov 15, 2023):

https://github.com/fatedier/frp/blob/dev/README.md#hot-reloading-frpc-configuration

thanks for the reply. Isn't hot reload for reloading frpc with a new configuration. I am not trying to use the HTTP API, only trying to reload a running client with an updated configuration

@rbose21 commented on GitHub (Nov 15, 2023): > https://github.com/fatedier/frp/blob/dev/README.md#hot-reloading-frpc-configuration thanks for the reply. Isn't hot reload for reloading frpc with a new configuration. I am not trying to use the HTTP API, only trying to reload a running client with an updated configuration

gitea-mirror commented

2026-05-05 13:56:14 -06:00

Author

Owner

@superzjg commented on GitHub (Nov 16, 2023):

https://github.com/fatedier/frp/blob/dev/README.md#hot-reloading-frpc-configuration

thanks for the reply. Isn't hot reload for reloading frpc with a new configuration. I am not trying to use the HTTP API, only trying to reload a running client with an updated configuration

May not support this feature.

@superzjg commented on GitHub (Nov 16, 2023): > > https://github.com/fatedier/frp/blob/dev/README.md#hot-reloading-frpc-configuration > > thanks for the reply. Isn't hot reload for reloading frpc with a new configuration. I am not trying to use the HTTP API, only trying to reload a running client with an updated configuration May not support this feature.

gitea-mirror commented

2026-05-05 13:56:15 -06:00

Author

Owner

@github-actions[bot] commented on GitHub (Dec 17, 2023):

Issues go stale after 30d of inactivity. Stale issues rot after an additional 7d of inactivity and eventually close.

@github-actions[bot] commented on GitHub (Dec 17, 2023): Issues go stale after 30d of inactivity. Stale issues rot after an additional 7d of inactivity and eventually close.