Skip to content

Move from Stash

How to move your Clash subscription, servers, proxy groups and rules from Stash to Potatso on iPhone and iPad, and what carries over.

Updated View as Markdown

Stash uses Clash configurations, and Potatso reads them too. Import the same subscription URL or configuration file, and your proxies, proxy groups, rules, rule providers and DNS settings come along.

Bring your subscription

  1. Copy the subscription URL you use in Stash.
  2. In Potatso, on Home, tap the + button, then Import via Link/File.
  3. Paste the URL and tap Continue.
  4. Check the preview. Under Import To, choose where it goes, then tap the button at the bottom.

A subscription imported from a URL keeps updating, daily by default. Changes you make in Potatso are kept across updates. See Import subscriptions and configurations.

Bring a configuration file

If you edited your configuration in Stash, or it isn't from a URL, import the YAML file instead:

  1. In Potatso, tap +, then Import via Link/File.
  2. Under Source, choose File, then tap Choose File… and pick the file. It must be UTF-8 text and no larger than 5 MB.
  3. Tap Continue, check the preview, and import.

A file is imported once: it has nothing to update from.

What carries over

From a Stash configuration In Potatso
Proxies with a supported protocol ✅ See Protocols.
Proxy providers ✅
Proxy groups: select, url-test, fallback, load-balance, relay ✅
Rules and rule providers ✅ Rules Potatso can't represent are skipped.
DNS settings ✅
mode (rule, global, direct) ✅ Becomes the profile's outbound mode.
Proxies of other types, such as WireGuard or TUIC ❌ Skipped
HTTPS decryption (MitM), rewrites, scripts ❌ Potatso has none of these.

The preview lists everything it skipped under Compatibility Issues, with the reason. Skipped rules are listed with their rule number, so you can find them in your configuration.

After you import

  1. On Home, check the outbound mode. A Clash configuration with rules imports in Rule mode, unless its mode says otherwise. See Outbound modes.
  2. Turn on the switch on the status card to connect. The first time, iOS asks to add Potatso's VPN configuration: tap Allow.

Disconnect Stash before you connect Potatso.

To change rules and groups after import, see Rules and rule sets and Proxy groups and speed tests.

Navigation

Type to search…

↑↓ navigate↵ selectEsc close