[REQUEST] - Bulk edit Advanced Options for multiple Hosts

[bebricoOOOOOOf]

Reference Issues

#395

Summary

Feature request

Please add a bulk edit action for Hosts, especially for Advanced Options.

Current problem:
When an admin has many hosts, changing the same option for all of them is very time-consuming. For example, changing the uTLS / client fingerprint from chrome to firefox requires editing each host manually.

Suggested solution

Add a bulk action in the Hosts page:

1. Select multiple hosts
2. Click "Bulk edit"
3. Choose one or more fields to update
4. Apply changes to all selected hosts

Useful fields for bulk editing:

• fingerprint / uTLS fingerprint
• SNI
• ALPN
• allowInsecure
• security / flow
• port
• path
• host-related Advanced Options

Why it is useful

This would make host management much easier for installations with many hosts. It would also reduce configuration mistakes when the same option needs to be changed across many hosts.

Example use case

I have 29 hosts and need to change the fingerprint from chrome to firefox. Currently this requires opening and editing every host one by one.

Basic Example

Example workflow:

1. Open the Hosts page
2. Select several hosts using checkboxes
3. Click "Bulk edit"
4. Choose the fields to update
5. Set fingerprint to firefox
6. Apply changes to all selected hosts

Example use case:

An admin has 29 hosts and wants to change the fingerprint from chrome to firefox. With the current UI, every host has to be edited one by one. With bulk editing, the admin could select all required hosts and apply the new fingerprint in one action.

Fields that would be useful for bulk editing:

• fingerprint / uTLS fingerprint
• SNI
• ALPN
• allowInsecure
• security / flow
• port
• path
• other host Advanced Options

Drawbacks

The main drawback is that bulk editing can accidentally change many hosts at once if used incorrectly.

To reduce this risk, the UI could show a confirmation dialog before applying changes, for example:

"You are about to update 29 hosts. This action will change the selected fields for all selected hosts."

It may also be better to update only explicitly selected fields, so empty fields do not overwrite existing host settings by mistake.

Unresolved questions

A few implementation details may need to be decided:

• Should bulk editing be available only for Advanced Options, or for all host fields?
• Should the UI allow editing multiple fields at once, or only one field per bulk action?
• Should there be a confirmation preview showing which hosts and fields will be changed?
• Should this feature be limited to admins with specific permissions?

[legiz-ru]

use api for automatic

ALERT AI

EXAMPLE

While bulk editing in the UI is not yet available, you can update the fingerprint on all (or filtered) hosts using the Remnawave REST API right now.

📋 bash / cURL — change fingerprint on ALL hosts

API_URL="https://YOUR_PANEL_URL"
TOKEN="YOUR_TOKEN"
NEW_FP="firefox"   # chrome | firefox | safari | ios | android | edge | qq | random | randomized

# 1. Fetch all host UUIDs
UUIDS=$(curl -s -X GET "$API_URL/api/hosts" \
  -H "Authorization: Bearer $TOKEN" \
  | python3 -c "import sys,json; [print(h['uuid']) for h in json.load(sys.stdin)['response']]")

# 2. Patch each host — only uuid + fingerprint are sent, nothing else changes
for UUID in $UUIDS; do
  echo "Updating $UUID ..."
  curl -s -X PATCH "$API_URL/api/hosts" \
    -H "Authorization: Bearer $TOKEN" \
    -H "Content-Type: application/json" \
    -d "{\"uuid\": \"$UUID\", \"fingerprint\": \"$NEW_FP\"}"
  echo
done

echo "Done!"

📋 PowerShell — change fingerprint on ALL hosts

$API_URL = "https://YOUR_PANEL_URL"
$TOKEN   = "YOUR_TOKEN"
$NEW_FP  = "firefox"   # chrome | firefox | safari | ios | android | edge | qq | random | randomized

$headers = @{
    "Authorization" = "Bearer $TOKEN"
    "Content-Type"  = "application/json"
}

# 1. Fetch all hosts
$hosts = (Invoke-RestMethod -Uri "$API_URL/api/hosts" -Method GET -Headers $headers).response
Write-Host "Found $($hosts.Count) hosts"

# 2. Patch each host — only uuid + fingerprint are sent, nothing else changes
foreach ($h in $hosts) {
    $body = @{ uuid = $h.uuid; fingerprint = $NEW_FP } | ConvertTo-Json
    Invoke-RestMethod -Uri "$API_URL/api/hosts" -Method PATCH -Headers $headers -Body $body | Out-Null
    Write-Host "Updated: $($h.remark)  [$($h.uuid)]"
}
Write-Host "Done!"

📋 PowerShell — change fingerprint only on hosts where fingerprint = chrome

$API_URL = "https://YOUR_PANEL_URL"
$TOKEN   = "YOUR_TOKEN"
$OLD_FP  = "chrome"
$NEW_FP  = "firefox"

$headers = @{
    "Authorization" = "Bearer $TOKEN"
    "Content-Type"  = "application/json"
}

$hosts   = (Invoke-RestMethod -Uri "$API_URL/api/hosts" -Method GET -Headers $headers).response
$targets = $hosts | Where-Object { $_.fingerprint -eq $OLD_FP }
Write-Host "Hosts to update: $($targets.Count)"

foreach ($h in $targets) {
    $body = @{ uuid = $h.uuid; fingerprint = $NEW_FP } | ConvertTo-Json
    Invoke-RestMethod -Uri "$API_URL/api/hosts" -Method PATCH -Headers $headers -Body $body | Out-Null
    Write-Host "Updated: $($h.remark)"
}

How it works:

• GET /api/hosts — returns all hosts with their UUIDs
• PATCH /api/hosts — accepts { uuid, fingerprint }; only the fields you pass are changed, all other host settings stay untouched

Available fingerprint values: chrome, firefox, safari, ios, android, edge, qq, random, randomized

This also works for any other patchable field (sni, alpn, allowInsecure, port, path, etc.) — just swap the key/value in the body.

---

This is a reasonable interim solution, but a native bulk-edit UI (as described in the issue) would still be very valuable for non-technical admins.

[Kenya-West]

@legiz-ru just a little addition for users that run Caddy with custom path setup:

Details

$API_URL = "https://PANEL_URL"
$CADDY_TOKEN = "token" # Caddy auth API token, if you are running Caddy with custom path setup
$TOKEN   = "" # Remnawave panel API token
$NEW_FP  = "firefox"   # chrome | firefox | safari | ios | android | edge | qq | random | randomized

$headers = @{
    "Authorization" = "Bearer $TOKEN"
    "Content-Type"  = "application/json"
    "X-Api-Key"     = "$CADDY_TOKEN"
}

# 1. Fetch all hosts
$hosts = (Invoke-RestMethod -Uri "$API_URL/api/hosts" -Method GET -Headers $headers).response
Write-Host "Found $($hosts.Count) hosts"

# 2. Patch each host — only uuid + fingerprint are sent, nothing else changes
foreach ($h in $hosts) {
    $body = @{ uuid = $h.uuid; fingerprint = $NEW_FP } | ConvertTo-Json
    Invoke-RestMethod -Uri "$API_URL/api/hosts" -Method PATCH -Headers $headers -Body $body | Out-Null
    Write-Host "Updated: $($h.remark)  [$($h.uuid)]"
}
Write-Host "Done!"