feat(storage): storage file structure changes (#3301)

mirror of https://github.com/qdm12/gluetun.git synced 2026-06-12 23:32:15 +02:00

- migrate persisted server data storage from `/gluetun/servers.json` to `/gluetun/servers/`
- add `STORAGE_SERVERS_ENABLED=on` to enable or disable on-disk server data storage
- add `STORAGE_SERVERS_DIRECTORY_PATH=/gluetun/servers` to configure where per-provider server files are stored
- keep backward compatibility with legacy `STORAGE_FILEPATH=/gluetun/servers.json`
- automatically read and migrate legacy `/gluetun/servers.json` into the new `/gluetun/servers/` layout when needed
- try to remove the legacy servers file after a successful migration to the new storage directory
- switch persisted server data from one large JSON file to a manifest plus per-provider JSON files
- add `UPDATER_PREFER_DIRECT_DOWNLOAD` to allow preferring direct download of provider server data
- keep deprecated updater flags `-enduser` and `-maintainer` as no-op warnings for backward compatibility
- preserve compatibility checks so persisted server data is discarded when its schema version no longer matches the built-in data
- allow preferred persisted provider data to override built-in data when versions match
- servers data now lives at https://github.com/qdm12/gluetun-servers/tree/main/pkg/servers

This commit is contained in:

Quentin McGaw

2026-05-18 22:28:25 -04:00

committed by

GitHub

parent cd19093d1d

commit 8f82376996

31 changed files with 654 additions and 304041 deletions

									
										go.mod
									
		+1
		
												View File
												
				@@ -15,6 +15,7 @@ require (

					github.com/mdlayher/netlink v1.9.0

					github.com/pelletier/go-toml/v2 v2.2.4

					github.com/qdm12/dns/v2 v2.0.0-rc9.0.20260421173011-9de8e7fdbe3a

					github.com/qdm12/gluetun-servers v0.1.0

					github.com/qdm12/gosettings v0.4.4

					github.com/qdm12/goshutdown v0.3.0

					github.com/qdm12/gosplash v0.2.1-0.20260305164749-b713de4fee6c