Upgrading from v1 to v2

This guide helps migrate from TSDProxy v1 to v2.

Before You Upgrade

services:
  tsdproxy:
    image: almeidapaulopt/tsdproxy:2

Add extra_hosts if missing:

    extra_hosts:
      - "host.docker.internal:host-gateway"

Rename files: to lists: in tsdproxy.yaml.

Update list files from v1 format to v2 multi-port format:

# v1
nas1:
  url: https://192.168.1.2:5001

# v2
nas1:
  ports:
    443/https:
      targets:
        - https://192.168.1.2:5001

V1	V2
`tsdproxy.container_port: 8080`	`tsdproxy.port.1: "443/https:8080/http"`
`tsdproxy.scheme: https`	`tsdproxy.port.1: "443/https:443/https"`
`tsdproxy.tlsvalidate: false`	`tsdproxy.port.1: "443/https:80/http, no_tlsvalidate"`
`tsdproxy.funnel: true`	`tsdproxy.port.1: "443/https:80/http, tailscale_funnel"`

docker compose pull && docker compose up -d

Check Dashboard at http://<IP>:8080.

docker compose down
# Restore config backup
# Change image tag back to almeidapaulopt/tsdproxy:1
docker compose up -d

Last updated on April 30, 2026