Skip to content

Troubleshooting ​

INFO

For help, ask in #help on our Discord or open an issue on GitHub. Please add what you tried and what the setup page or docker logs wa-classic shows.

The setup page doesn't open ​

Is Docker running? This should list wa-classic:

sh
docker ps

The log shows what happened:

sh
docker logs wa-classic

The iPhone can't reach the bridge ​

  • It has to be in the same Wi-Fi as the computer.
  • The address must be the computer's address in your home network, not "localhost".
  • On Windows, check that Docker may use private networks in the firewall.

Cydia can't load the source ​

  • Check the address: http://cydia.waclassic.com, with http, not https.
  • Check that the iPhone is online, for example by opening a page in Safari.
  • Still nothing? Use your bridge as the source instead: the address from the setup page, ending with /repo/.

The code is wrong or expired ​

Press New code on the setup page. A code is valid for 30 minutes and stops working after 10 wrong tries.

I forgot the setup page password ​

sh
docker exec wa-classic rm /data/admin.json

Then reload the page and choose a new password.

No messages arrive ​

  • Is the computer asleep? While it sleeps, no messages reach the iPhone. See "Keeping it running" on your installation page.
  • Away from home: check the port forwarding.

WA Classic is an unofficial client and not affiliated with, endorsed by or connected to WhatsApp or Meta.