Troubleshooting

The App Won’t Open on My Mac

  • Make sure the app is in Applications — not in Documents, Desktop or Downloads. macOS blocks it from starting in those folders.
  • After an update, the first start can take about 10 seconds while macOS checks it.
  • There’s no Dock icon — it runs in the background. Double-click DistributionApp in Applications to open the window again.

Staff Can’t Connect

  1. Is the main computer on, awake and the app running? See Keep It Running.
  2. Are they on the same Wi-Fi as the main computer?
  3. The address may have changed after a router restart — use the .local address on Staff Access, or reserve the main computer’s address in your router.
  4. On Windows, allow the app through the firewall for Private networks.

It Doesn’t Work Outside the Office

  • Is Tailscale on, on both the phone and the main computer?
  • The secure (https) address needs MagicDNS and HTTPS Certificates turned on in Tailscale — Settings → Remote Access shows how.
  • A DNS or ad-blocking profile on the phone can block the address. Try the number address under it, or remove the profile.

“Read-only — Activate the App”

The free trial has ended, or the license couldn’t be checked. Paste your license key or activation code in License. If you renamed your company, an old activation code won’t match — ask for a new one.

I Can’t Approve an Order

  • The customer may be on credit hold (overdue invoice, bounced check or over the credit limit) — the order page says why.
  • There may not be enough stock — another order may have been approved first.
  • You may not have permission to approve — ask your admin.

No Sound for New Approvals

Open My Account → Notifications → “Not hearing new approvals?” for the steps for your browser, or turn on Desktop Notifications.

I Deleted or Changed Something by Mistake

Check the Activity Log to see what changed. If needed, the admin can restore a backup from before it happened — remember that work done after that backup is lost.

Still Stuck?

Email alfiesuperhalk@gmail.com with a screenshot and what you were doing. We reply within one business day.

See Also

Back to top

Not all features are available in every copy of Distribution App. Some features, such as Payment QR Code, Salesman Locations and Signed Delivery Receipts, are add-ons that must first be switched on in Settings › Features. Once the free trial ends, the app needs a license key or activation code. Distribution App runs on Mac and Windows; staff phones and tablets connect through the office computer on the same Wi-Fi network. Tax records, receipts and reports follow Philippine (BIR) rules and may not suit businesses in other countries. Screens in this guide show the Demo Company — all names, addresses and prices are made up — and may look slightly different from your version of the app. Features may change without notice. Learn more at github.com/totoantonio/DistributionApp. Copyright © 2026 totoantonio. All rights reserved.