PasteFerry (隔空贴): clipboard and file sync across macOS, Windows and Linux. Direct-first, end-to-end encrypted. Optional official access: no server to host. Independent self-hosting remains available.
Dart airdrop-alternativeclipboardclipboard-sharingclipboard-synccopy-pastecross-platformend-to-end-encryptionfile-syncfile-transferfluttergolanglinuxmacosnat-traversalp2pself-hostedtailscaleuniversal-clipboardwebrtcwindows
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<script>
(function () {
if (location.hostname !== "baiyuze.github.io") return;
var prefix = /^\/(?:pasteferry|copysync)(?=\/|$)/.exec(location.pathname);
if (!prefix) return;
var path = location.pathname.slice(prefix[0].length) || "/";
location.replace("https://pasteferry.cc" + path + location.search + location.hash);
})();
</script>
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Quick start: set up PasteFerry in three steps</title>
<meta name="description" content="New to PasteFerry? Install the app on each computer. On the same network, just pair; on different networks, turn on Service. Then copy on one computer and paste on the other.">
<link rel="canonical" href="https://pasteferry.cc/en/start/">
<link rel="alternate" hreflang="zh-CN" href="https://pasteferry.cc/start/">
<link rel="alternate" hreflang="zh-TW" href="https://pasteferry.cc/zh-tw/start/">
<link rel="alternate" hreflang="zh-HK" href="https://pasteferry.cc/zh-hk/start/">
<link rel="alternate" hreflang="en" href="https://pasteferry.cc/en/start/">
<link rel="alternate" hreflang="ja" href="https://pasteferry.cc/ja/start/">
<meta name="theme-color" content="#141416">
<meta property="og:type" content="article">
<meta property="og:site_name" content="PasteFerry">
<meta property="og:title" content="Quick start: set up PasteFerry in three steps">
<meta property="og:description" content="New to PasteFerry? Install the app on each computer. On the same network, just pair; on different networks, turn on Service. Then copy on one computer and paste on the other.">
<meta property="og:url" content="https://pasteferry.cc/en/start/">
<meta property="og:image" content="https://pasteferry.cc/assets/og-en.png">
<meta property="og:locale" content="en_US">
<meta name="twitter:card" content="summary_large_image">
<link rel="icon" href="../../assets/favicon.svg?v=df696024d8" type="image/svg+xml">
<link rel="icon" href="../../assets/favicon-32.png?v=8e9afa506d" sizes="32x32" type="image/png">
<link rel="apple-touch-icon" href="../../assets/apple-touch-icon.png?v=bcbf406cb8">
<link rel="stylesheet" href="../../assets/site.css?v=dbae55d27c">
<script>document.documentElement.classList.add("js");if (!/Mac|iPhone|iPad/.test(navigator.platform || navigator.userAgent)) document.documentElement.classList.add("pc");</script>
</head>
<body>
<a class="skip" href="#main">Skip to content</a>
<header class="bar">
<div class="wrap">
<a class="brand" href="../../en/" aria-label="PasteFerry home"><img src="../../assets/icon.svg?v=65a69999e0" alt="" width="26" height="26">PasteFerry</a>
<nav aria-label="Page">
<a href="../../en/features/">Features</a>
<a class="mid" href="./" aria-current="page">Quick start</a>
<a class="wide" href="#server">Ways to connect</a>
<a href="../../en/download/">Download</a>
<details class="menu">
<summary aria-label="More pages"><span>More</span><svg class="chev" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m3 4.5 3 3 3-3"/></svg></summary>
<ul>
<li class="narrow"><a href="./" aria-current="page">Quick start</a></li>
<li class="narrow"><a href="#server">Ways to connect</a></li>
<li><a href="../../en/themes/">Themes guide</a></li>
<li><a href="../../en/how/">How it works</a></li>
<li><a href="../../en/security/">Security</a></li>
<li><a href="../../en/faq/">FAQ</a></li>
<li><a href="../../en/feedback/">Discussion & feedback</a></li>
<li class="sep" role="separator"></li>
<li><a href="https://github.com/baiyuze/pasteferry/blob/main/CHANGELOG.md">Changelog</a></li>
<li class="narrow-gh"><a href="https://github.com/baiyuze/pasteferry">GitHub</a></li>
</ul>
</details>
<a class="gh" href="https://github.com/baiyuze/pasteferry" data-gh-stars aria-label="Star PasteFerry on GitHub"><svg class="gh-mark" viewBox="0 0 16 16" aria-hidden="true"><path fill="currentColor" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"/></svg><span class="gh-label">Star</span><span class="gh-count" hidden><svg class="gh-star" viewBox="0 0 16 16" aria-hidden="true"><path fill="currentColor" d="M8 .25a.75.75 0 01.673.418l1.882 3.815 4.21.612a.75.75 0 01.416 1.279l-3.046 2.97.719 4.192a.751.751 0 01-1.088.791L8 12.347l-3.766 1.98a.75.75 0 01-1.088-.79l.72-4.194L.818 6.374a.75.75 0 01.416-1.28l4.21-.611L7.327.668A.75.75 0 018 .25z"/></svg><b></b></span></a>
<details class="lang">
<summary aria-label="Language:English"><svg viewBox="0 0 20 20" fill="none" stroke="currentColor" stroke-width="1.4" aria-hidden="true"><circle cx="10" cy="10" r="7.25"/><path d="M2.75 10h14.5M10 2.75c-2.1 2-3.1 4.4-3.1 7.25s1 5.25 3.1 7.25M10 2.75c2.1 2 3.1 4.4 3.1 7.25s-1 5.25-3.1 7.25"/></svg><span>English</span><svg class="chev" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m3 4.5 3 3 3-3"/></svg></summary>
<ul>
<li><a href="../../start/" hreflang="zh-CN" lang="zh-CN" data-lang="zh">简体中文</a></li>
<li><a href="../../zh-tw/start/" hreflang="zh-TW" lang="zh-TW" data-lang="zh-tw">繁體中文(台灣)</a></li>
<li><a href="../../zh-hk/start/" hreflang="zh-HK" lang="zh-HK" data-lang="zh-hk">繁體中文(香港)</a></li>
<li><a href="../../en/start/" hreflang="en" lang="en" data-lang="en" aria-current="page">English</a></li>
<li><a href="../../ja/start/" hreflang="ja" lang="ja" data-lang="ja">日本語</a></li>
</ul>
</details>
</nav>
</div>
</header>
<main id="main">
<section class="hero guide-hero">
<div class="wrap">
<p class="crumb"><a href="../../en/">PasteFerry</a> / Quick start</p>
<h1 class="display">Quick start</h1>
<p class="lede">Install the app, pick a way to connect, and pair your computers. On the same network it takes a few minutes.</p>
<ol class="guide-toc">
<li><a href="#app">Install the app</a></li>
<li><a href="#server">Pick a way to connect</a></li>
<li><a href="#pair">Pair</a></li>
<li><a href="#phone">Using a phone</a></li>
</ol>
</div>
</section>
<section class="section" id="app" aria-labelledby="app-title">
<div class="wrap">
<p class="eyebrow">Step 1</p>
<h2 id="app-title">Install the app on each computer</h2>
<p class="intro">One on every computer you want to sync. Mac, Windows and Linux mix freely.</p>
<div class="os-grid qs-grid">
<div>
<div class="qs-app">
<h3><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linejoin="round" aria-hidden="true"><rect x="4" y="5" width="16" height="11" rx="1.5"/><path d="M2 19h20"/></svg>Mac</h3>
<ol class="steps">
<li>Download the DMG, open it and drag PasteFerry into Applications.<span class="aside">There's one for Apple silicon and one for Intel; the download page helps you choose.</span></li>
<li>Open it from Applications.<span class="aside">The first time, macOS says it can't verify the developer: go to System Settings → Privacy & Security and click Open Anyway near the bottom.</span></li>
<li>Click Turn on background sync. When macOS asks about clipboard access and finding devices on your local network, allow both.</li>
</ol>
<a class="button" href="../../en/download/#macos"><svg viewBox="0 0 20 20" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M10 3v10m0 0-4-4m4 4 4-4M4 16h12"/></svg>Download for Mac</a>
</div>
<div class="qs-app">
<h3><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linejoin="round" aria-hidden="true"><rect x="3" y="4" width="18" height="12" rx="1.5"/><path d="M9 20h6M12 16v4"/></svg>Windows</h3>
<ol class="steps">
<li>Run PasteFerry-Setup.exe; no administrator rights needed.<span class="aside">If you see "Windows protected your PC", click More info, then Run anyway.</span></li>
<li>Open PasteFerry and click Turn on background sync. Allow it if Windows Firewall asks. After you close the window it keeps running in the notification area.</li>
</ol>
<a class="button" href="../../en/download/#windows"><svg viewBox="0 0 20 20" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M10 3v10m0 0-4-4m4 4 4-4M4 16h12"/></svg>Download for Windows</a>
</div>
<div class="qs-app">
<h3><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linejoin="round" aria-hidden="true"><rect x="3" y="4" width="18" height="12" rx="1.5"/><path d="M9 20h6M12 16v4"/></svg>Linux</h3>
<ol class="steps">
<li>On Ubuntu, Debian and similar, install the .deb; on other distributions, extract the tar.gz and run the <code>install.sh</code> inside.</li>
<li>Open PasteFerry from the app menu and click Turn on background sync.</li>
</ol>
<a class="button" href="../../en/download/#linux"><svg viewBox="0 0 20 20" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M10 3v10m0 0-4-4m4 4 4-4M4 16h12"/></svg>Download for Linux</a>
</div>
</div>
<figure class="shot">
<img src="../../assets/screenshots/en/welcome-dark.png?v=3d4d07f16e" width="2112" height="1472" alt="PasteFerry the first time it opens, asking you to turn on background sync">
</figure>
</div>
</div>
</section>
<section class="section" id="server" aria-labelledby="server-title">
<div class="wrap">
<p class="eyebrow">Step 2</p>
<h2 id="server-title">Pick a way to connect</h2>
<p class="intro">On the same network, install and pair. On different networks, turn on Service. If you want full control, run your own server or use Tailscale.</p>
<div class="os-tabs" data-tabs="plan">
<div class="tablist" role="tablist" aria-label="Ways to connect" hidden>
<button type="button" role="tab" id="tab-plan-official" aria-controls="plan-official">Service</button>
<button type="button" role="tab" id="tab-plan-lan" aria-controls="plan-lan">Same network</button>
<button type="button" role="tab" id="tab-plan-cloud" aria-controls="plan-cloud">Your own public server</button>
<button type="button" role="tab" id="tab-plan-ts" aria-controls="plan-ts">Tailscale</button>
</div>
<section class="os" id="plan-official" role="tabpanel" aria-labelledby="tab-plan-official">
<h3 class="os-title">Service</h3>
<div class="plan-grid">
<div>
<ol class="steps">
<li>Install the latest version on each computer and click Turn on background sync.</li>
<li>Turn on Use the service in Settings → Connection.</li>
<li>Pair the two computers. Computers you've already paired don't need to pair again.</li>
</ol>
<p class="plan-address">Service is off in a new install. The server never receives what you copy; see the privacy notice.</p>
<a class="button quiet" href="../../en/official/">Turn on Service →</a>
</div>
<div class="plan-card">
<svg viewBox="0 0 240 112" aria-hidden="true"><rect class="p-dev" x="98" y="8" width="44" height="12" rx="3"/><rect class="p-dev" x="98" y="23" width="44" height="12" rx="3"/><rect class="p-net" x="6" y="50" width="100" height="56" rx="10"/><rect class="p-net" x="134" y="50" width="100" height="56" rx="10"/><path class="p-sig" d="M56 64V22h42M184 64V22h-42"/><path class="p-data" d="M80 80h80"/><rect class="p-dev" x="37" y="64" width="38" height="24" rx="3"/><path class="p-dev" d="M32 93h48"/><rect class="p-dev" x="165" y="64" width="38" height="24" rx="3"/><path class="p-dev" d="M160 93h48"/></svg>
<dl>
<div><dt>Direct whenever possible</dt><dd>The computers connect directly when they can and go through the server only when they can't. Content is encrypted, and the server can't decrypt it.</dd></div>
<div><dt>100 MB of relay a day, direct unlimited</dt><dd>Relay is limited to 100 MB per computer per day; direct is unlimited. The usage page shows how much is left.</dd></div>
</dl>
</div>
</div>
</section>
<section class="os" id="plan-lan" role="tabpanel" aria-labelledby="tab-plan-lan">
<h3 class="os-title">Same network</h3>
<div class="plan-grid">
<div>
<ol class="steps">
<li>Install the app on each computer and click Turn on background sync.</li>
<li>Allow PasteFerry when Windows Firewall or macOS asks about the local network.</li>
<li>Show a code on one computer, enter it on the other and compare fingerprints. On a different subnet, also enter the address shown under the code; see the <a href="../../en/lan/#subnet">same network guide</a>.</li>
</ol>
<p class="plan-address">No server address to enter.</p>
<a class="button quiet" href="../../en/lan/">Same network guide →</a>
</div>
<div class="plan-card">
<svg viewBox="0 0 240 112" aria-hidden="true"><rect class="p-net" x="6" y="6" width="228" height="100" rx="14"/><path class="p-data" d="M82 52h76"/><rect class="p-dev" x="39" y="40" width="38" height="24" rx="3"/><path class="p-dev" d="M34 69h48"/><rect class="p-dev" x="163" y="40" width="38" height="24" rx="3"/><path class="p-dev" d="M158 69h48"/></svg>
<dl>
<div><dt>Best for</dt><dd>Home or office, with both computers on the same Wi‑Fi or wired network.</dd></div>
<div><dt>You need</dt><dd>Nothing but the app on each computer.</dd></div>
<div><dt>Keep in mind</dt><dd>Sync stops when you leave the network and resumes when you're back. If wired and Wi‑Fi are on different subnets, you enter one extra address when pairing.</dd></div>
</dl>
</div>
</div>
</section>
<section class="os" id="plan-cloud" role="tabpanel" aria-labelledby="tab-plan-cloud">
<h3 class="os-title">Your own public server</h3>
<div class="plan-grid">
<div>
<ol class="steps">
<li>In your cloud provider's security group, open TCP 8787, UDP 3478 and UDP 32768–60999.</li>
<li>Log in with ssh, download the install script and run it: <code>sudo ./install.sh PUBLIC_IP</code>.</li>
<li>In Settings → Connection on each computer, enter <code>ws://PUBLIC_IP:8787/signal</code>, press Return, then pair.</li>
</ol>
<p class="plan-address">Open <code>http://PUBLIC_IP:8787/healthz</code> in a browser. If it says ok, it's running.</p>
<a class="button quiet" href="../../en/cloud/">Public server guide →</a>
</div>
<div class="plan-card">
<svg viewBox="0 0 240 112" aria-hidden="true"><rect class="p-dev" x="98" y="8" width="44" height="12" rx="3"/><rect class="p-dev" x="98" y="23" width="44" height="12" rx="3"/><rect class="p-net" x="6" y="50" width="100" height="56" rx="10"/><rect class="p-net" x="134" y="50" width="100" height="56" rx="10"/><path class="p-sig" d="M56 64V22h42M184 64V22h-42"/><path class="p-data" d="M80 80h80"/><rect class="p-dev" x="37" y="64" width="38" height="24" rx="3"/><path class="p-dev" d="M32 93h48"/><rect class="p-dev" x="165" y="64" width="38" height="24" rx="3"/><path class="p-dev" d="M160 93h48"/></svg>
<dl>
<div><dt>Best for</dt><dd>Running the server yourself, or relaying a lot of traffic.</dd></div>
<div><dt>You need</dt><dd>A Linux VM with a public IP and root access.</dd></div>
<div><dt>Keep in mind</dt><dd>The VM costs money, and relay speed is limited by its bandwidth. In mainland China, enter the IP unless the domain has an ICP filing.</dd></div>
</dl>
</div>
</div>
</section>
<section class="os" id="plan-ts" role="tabpanel" aria-labelledby="tab-plan-ts">
<h3 class="os-title">Tailscale</h3>
<div class="plan-grid">
<div>
<ol class="steps">
<li>Install Tailscale on each computer and sign in to the same account.</li>
<li>On the other computer, run <code>tailscale ip -4</code> and note the address starting with 100.</li>
<li>When pairing, click On a different subnet? and enter that address.</li>
</ol>
<p class="plan-address">No server needed. A Tailscale address doesn't change, so you enter it once, when pairing.</p>
<a class="button quiet" href="../../en/tailscale/">Tailscale guide →</a>
</div>
<div class="plan-card">
<svg viewBox="0 0 240 112" aria-hidden="true"><rect class="p-ts" x="2" y="2" width="236" height="108" rx="16"/><rect class="p-net" x="12" y="12" width="98" height="88" rx="10"/><rect class="p-net" x="130" y="12" width="98" height="88" rx="10"/><path class="p-data" d="M85 52h71"/><rect class="p-dev" x="42" y="40" width="38" height="24" rx="3"/><path class="p-dev" d="M37 69h48"/><rect class="p-dev" x="161" y="40" width="38" height="24" rx="3"/><path class="p-dev" d="M156 69h48"/></svg>
<dl>
<div><dt>Best for</dt><dd>You already use Tailscale, or don't want to depend on any server.</dd></div>
<div><dt>You need</dt><dd>Tailscale on every computer, signed in to the same account.</dd></div>
<div><dt>Keep in mind</dt><dd>Tailscale has to stay connected. When it can't connect two computers directly, it relays through its own servers, which can be slow.</dd></div>
</dl>
</div>
</div>
</section>
</div>
</div>
</section>
<section class="section" id="pair" aria-labelledby="pair-title">
<div class="wrap">
<p class="eyebrow">Step 3</p>
<h2 id="pair-title">Pair your computers</h2>
<p class="intro">Pair any two computers once, and that's it.</p>
<div class="os-grid qs-grid">
<div>
<ol class="steps">
<li>On one computer, open Devices and click Add device. It shows a 6-character code, valid for 5 minutes, and this computer's address below it.</li>
<li>On the other computer, choose Add device → Enter a code. With Service there's no IP to enter; only across subnets or with Tailscale do you open the address field and enter the other computer's address.</li>
<li>Both screens show the same two fingerprint lines. Check them character by character, then confirm.<span class="aside">This stops anyone in the middle from posing as your device. Don't skip it.</span></li>
</ol>
<figure class="figure-card qs-verify">
<img src="../../assets/screenshots/en/card-verify-dark.png?v=0f0a9ff3bc" width="1120" height="800" loading="lazy" alt="The fingerprint check during pairing shows R8NF-2WTC-QL5J and asks you to confirm it matches the other computer exactly">
</figure>
</div>
<figure class="shot">
<img src="../../assets/screenshots/en/pairing-dark.png?v=f3e8ad175d" width="2112" height="1472" loading="lazy" alt="Add device: the pairing code K7MP2X, with this computer's address 192.168.1.20 below it">
</figure>
</div>
</div>
</section>
<section class="section" id="phone" aria-labelledby="phone-title">
<div class="wrap">
<h2 id="phone-title">Using a phone</h2>
<p class="intro">Once the computers are paired above, a phone can join any time: scan a code for the web page, or install the Android app.</p>
<div class="os-grid qs-grid">
<div>
<h3>The web page: nothing to install</h3>
<ol class="steps">
<li>Computer: open Devices › Phone web transfer, turn the switch on, and a code appears.</li>
<li>Phone: scan the code with the camera or a browser and give the phone a name.</li>
<li>The phone’s browser then shows the computer’s records: tap Copy to take a text to the phone, or use Send to push text, photos and files to the computer.</li>
</ol>
<h3>The Android app: pairs like another computer</h3>
<ol class="steps">
<li>Phone: <a href="https://github.com/baiyuze/pasteferry/releases/download/v2.10.1/PasteFerry-android-arm64.apk">download the APK</a> and install it (allow installing from unknown sources when asked).</li>
<li>Computer: Devices → Add device → Show a code.</li>
<li>Phone: enter the code and confirm when the two fingerprints match.</li>
<li>What you copy on the computer then appears in the phone’s records and clipboard.</li>
</ol>
</div>
</div>
</div>
</section>
<section class="closing" aria-labelledby="closing-title">
<div class="wrap">
<h2 class="display" id="closing-title">Now copy something.</h2>
<p class="lede">Copy text, an image or a file on one computer and press ⌘V or Ctrl+V on the other. Everything copied on either side is in the history.</p>
<p class="note">Need help? <a href="../../en/lan/#faq">Same network questions</a> · <a href="../../en/tailscale/#faq">Tailscale questions</a> · <a href="../../en/cloud/#faq">Public server questions</a> · <a href="https://github.com/baiyuze/pasteferry/issues">Report an issue</a></p>
</div>
</section>
</main>
<footer class="footer">
<div class="wrap">
<p>PasteFerry is open source under the GNU AGPL-3.0.</p>
<nav aria-label="Footer">
<a href="https://github.com/baiyuze/pasteferry/releases">All releases</a>
<a href="https://github.com/baiyuze/pasteferry/blob/main/CHANGELOG.md">Changelog</a>
<a href="https://pasteferry.cc/design/nat-traversal.html">Design notes (Chinese)</a>
<a href="https://github.com/baiyuze/pasteferry/blob/main/LICENSING.md">License</a>
<a href="https://github.com/baiyuze/pasteferry/issues">Report an issue</a>
<a href="../../en/privacy/">Privacy</a>
<a href="../../en/feedback/">Discussion & feedback</a>
</nav>
<nav aria-label="Language">
<a href="../../start/" hreflang="zh-CN" lang="zh-CN" data-lang="zh">简体中文</a>
<a href="../../zh-tw/start/" hreflang="zh-TW" lang="zh-TW" data-lang="zh-tw">繁體中文(台灣)</a>
<a href="../../zh-hk/start/" hreflang="zh-HK" lang="zh-HK" data-lang="zh-hk">繁體中文(香港)</a>
<a href="../../en/start/" hreflang="en" lang="en" data-lang="en" aria-current="page">English</a>
<a href="../../ja/start/" hreflang="ja" lang="ja" data-lang="ja">日本語</a>
</nav>
</div>
</footer>
<script src="../../assets/site.js?v=fb60f6e5ce" defer></script>
<script src="/assets/analytics.js?v=e2777f714d" defer></script>
<script type="module" src="https://static.cloudflareinsights.com/beacon.min.js" data-cf-beacon='{"token": "7ee226baf4a949a397c4bfd69a9e7461"}'></script>
</body>
</html>