Opening Stash for the first time

Beta builds of Stash aren't code-signed yet, so your computer asks you to confirm the first time you open it. You only need to do this once.

Mac

macOS may block Stash at first. Because the beta isn't signed by Apple yet, macOS can stop it from opening. If that happens, open System Settings → Privacy & Security, scroll down to the message about Stash, and click Open Anyway.

  1. Open Stash-mac.dmg and drag Stash into your Applications folder.
  2. Open Stash from Applications. macOS says it can't verify the developer; click Done.
  3. Open System Settings → Privacy & Security, scroll down, and click Open Anyway next to the Stash message.
  4. Confirm with your password or Touch ID. Stash opens, and from then on opens normally.

Windows

  1. Run Stash-Setup.exe.
  2. If you see "Windows protected your PC", click More info, then Run anyway.
  3. Follow the installer. Stash starts and adds itself to the system tray.

Connecting Gmail during the beta

While Google reviews Stash, only people on our tester list can connect Gmail with the normal sign-in. Email us your Gmail address to be added. When you sign in, Google shows "Google hasn't verified this app": click Advanced, then Go to Stash, and make sure the box to read your email is ticked.

Not on the list yet? You can connect Gmail right away with an app password instead: in Stash choose Other email → Gmail (app password) and follow the Gmail steps below.

App passwords for other email providers

iCloud, Yahoo, AOL and most other providers don't let apps use your normal password. Instead you create an app password, a separate password just for Stash that you can revoke at any time. Most providers require two-step verification to be on first.

iCloud Mail

  1. Sign in at account.apple.com.
  2. Go to Sign-In and Security → App-Specific Passwords.
  3. Create one named "Stash" and paste it into Stash.

Apple's instructions

Yahoo Mail

  1. Open Account Info → Account security.
  2. Choose Generate app password and name it "Stash".
  3. Paste the password into Stash.

Yahoo's instructions

Gmail (app password)

  1. Turn on 2-Step Verification in your Google Account.
  2. Open myaccount.google.com/apppasswords and create one named "Stash".
  3. In Stash choose Gmail (app password) and paste it in.

Google's instructions

AOL Mail

  1. Open Account Security in your AOL account.
  2. Choose Generate app password, name it "Stash".
  3. Paste the password into Stash.

AOL's instructions

Fastmail

  1. Go to Settings → Privacy & Security → App passwords.
  2. Create one with Mail (IMAP) access.
  3. Paste it into Stash.

Fastmail's instructions

Proton Mail

  1. Install and sign in to Proton Mail Bridge (paid plans).
  2. Copy the IMAP password Bridge shows for your account.
  3. In Stash choose Proton Mail (Bridge) and paste it in.

Other provider? Choose Other (enter server) in Stash and enter your provider's IMAP server, usually found by searching "<provider> IMAP settings".

Still stuck?

Email hello@jesskirsch.com and we'll help.