* DOCS / 02

Connecting to your Ultimate

Two protocols are involved: REST (device control and PRG injection) and FTP (file transfer). Set both up once in the Connection tab of Settings.

Docs / Connecting to your Ultimate

Device discovery

Click Scan. Retro Commander pings every host on your subnet on TCP port 80, then verifies each hit by hitting the Ultimate REST endpoint. Discovery typically completes in 1-2 seconds.

Discovered devices show their hostname and product (Ultimate-64, C64 Ultimate, or Ultimate-II+). Click one to copy its IP into the host field.

REST password

If your Ultimate's web UI is password-protected, enter the same password here. Leave it blank if it isn't. The password is stored in your local settings.json.

FTP credentials

Stock Ultimate firmware accepts anonymous FTP. If you've enabled authentication on the device, fill in Username and Password. Port is 21 unless your firmware was customised.

Test connection

Use the Test Connection button to verify both REST and FTP. The status dot turns green on success, red on failure with a short reason next to it (timeout, bad credentials, host unreachable).

Troubleshooting

  • "Host unreachable": the device isn't on, isn't on the same subnet, or your firewall blocked port 80/21. Try the device's web UI from the same PC first.
  • "401 Unauthorized" on REST: the REST password is wrong, or the device has no password set but you provided one. Clear it and try again.
  • "FTP login failed": verify the username (often empty / anonymous) and that the firmware allows external FTP.
  • Discovery returns nothing: some routers block ARP/scan traffic. Enter the IP manually - you can find it in the device's startup screen.