Support

How can we help?

Answers to the common questions are below. If you’re stuck, email us and a real person will reply.

Email us

Tell us what you dropped, what you expected and what happened. Include your DockDeploy version (DockDeploy → About DockDeploy) and your macOS version. If a build failed, attach its build log.

hello@dockdeploy.net

Getting started

How do I install DockDeploy?
  1. Download DockDeploy and open the disk image.
  2. Drag DockDeploy into your Applications folder, then open it from there.
  3. The setup guide connects Netlify or Vercel and adds DockDeploy to your Dock. It takes about a minute.
How do I see the setup guide again?

Choose Help → DockDeploy Setup Guide.

DockDeploy isn’t in my Dock any more

Open DockDeploy from your Applications folder. While it’s open, right-click its Dock icon and choose Options → Keep in Dock.

DockDeploy offered to move itself to Applications

Say yes. An app opened straight from the disk image can’t update itself, and its Dock icon stops working once the disk image is ejected.

Deploying

What can I drop on DockDeploy?

A build folder (such as dist, build or public), a project folder with a package.json or netlify.toml, a .zip file, or a single .html file. You can also right-click a folder in Finder and choose Deploy with DockDeploy, or press ⌃⌥⌘D to redeploy the last folder.

Deploy with DockDeploy isn’t in my right-click menu

Open DockDeploy → Settings → General and click Turn On… next to Finder, then switch on DockDeploy under Extensions in System Settings. Until it’s on, the item is under Services at the bottom of Finder’s right-click menu.

If you see it twice, you can hide the plain one in System Settings → Keyboard → Keyboard Shortcuts → Services.

My folder went to the wrong site

Open Settings → Folders and click the minus button beside the folder to forget it. The next time you drop it, DockDeploy asks which site it belongs to. To put the wrong site back the way it was, open it in Recent Deploys and click Undo.

My build failed

Click the version in Recent Deploys, then choose Show Build Log from its ⋯ menu to see what went wrong. Most failures come from the project itself, such as a missing dependency or a typo.

If you’d rather build the site yourself, drop the finished build folder instead, or turn off Settings → General → Build projects before deploying.

The pre-flight check found problems

Before uploading, DockDeploy checks your pages for broken links, missing images, files that only exist on your Mac, capitalization that will break online, and a few other common mistakes. Click the result next to the version to see each problem and the page it’s on.

Problems are things visitors would notice. Suggestions are optional improvements. You can still publish, but sending a preview first is the safe choice.

A page works on my Mac but not online

The most common cause is capitalization. Your Mac treats Photo.JPG and photo.jpg as the same file, but web servers don’t. The pre-flight check finds these and tells you which file to rename.

Previews and undo

How do I make a preview instead of going live?

Hold ⌥ Option while you drop. To make every drop a preview, turn on Settings → General → Deploy as a preview first. When the preview looks right, click Publish.

My client can’t open a Vercel preview

Vercel only lets your team open previews by default. Turn on Settings → Accounts → Make preview links shareable. DockDeploy then adds a code to preview links so anyone you share them with can open them, without a Vercel account.

Why is a preview marked Outdated?

A newer version went live after the preview was made, so publishing it would undo those newer changes. Drop your folder again to make a fresh preview.

How do I undo a deploy?

Click Undo on the site in Recent Deploys to put back the version that was live before. To go further back, open the site and choose Revert to This Version from any version’s ⋯ menu. Nothing is uploaded, so it takes seconds.

If the site also deploys from Git, the next push replaces what you reverted to. On Netlify, DockDeploy can pause automatic publishing until you’re ready.

Teams

DockDeploy says someone else published the site

Someone published the site since you last deployed from your folder, so your folder may be missing their changes. DockDeploy lists the files your upload would replace. Choose Deploy as Preview to check first, or get their latest files before deploying.

How do I post deploys to Slack, Microsoft Teams or Discord?
  1. Create an incoming webhook for the channel in Slack, Teams or Discord, and copy its link.
  2. In DockDeploy, open Settings → Team and paste the link into Post to Slack or Microsoft Teams.
  3. Click Send Test Message and check the channel.
How do teammates deploy the same folder to the same site?

Leave Settings → Team → Save a link file in deployed folders on. DockDeploy saves a small .dockdeploy.json in the folder, so anyone who drops it from Dropbox, Google Drive or Git deploys to the same site. Each person needs access to the site on Netlify or Vercel.

Domains

How do I use my own domain?

In Recent Deploys, open the site’s ⋯ menu and choose Connect a Domain. DockDeploy adds the domain to your site, shows the records to add where your domain is managed, and checks every 30 seconds until it works.

My domain has been waiting for a long time

DNS changes usually show up within minutes but can take a few hours. Check that the records match exactly, with no extra spaces or dots. If your domain uses Cloudflare, set each record’s proxy status to DNS only (grey cloud) so a secure certificate can be issued.

Accounts and limits

DockDeploy says my sign-in expired

Open Settings → Accounts, remove the account, and connect it again. If you used an access token, create a new one with your host first.

How many deploys can I make?

That depends on your Netlify or Vercel plan, not on DockDeploy. The bottom of DockDeploy’s window shows your remaining Netlify credits and Vercel daily deploys. DockDeploy only uploads files that changed, but every live deploy still counts.

Updates

How do I update DockDeploy?

DockDeploy checks for updates once a day and asks before installing. To check now, choose DockDeploy → Check for Updates. Updates are signed, so only genuine versions are installed.

Uninstalling

Quit DockDeploy and drag it from Applications to the Trash. To remove everything it kept on your Mac too:

  1. In Finder, choose Go → Go to Folder and delete ~/Library/Caches/DockDeploy, ~/Library/Logs/DockDeploy and ~/Library/Preferences/com.matthewphillips.DockDeploy.plist.
  2. Open Keychain Access, search for “DockDeploy” and delete the items it finds.
  3. Optionally, delete the .dockdeploy.json files in folders you deployed.

Your sites stay on Netlify and Vercel. See Privacy for what DockDeploy stores.