Chrysalis

Troubleshooting

Start with the log. It is in the window where Chrysalis started, in data/logs/chrysalis.log, and behind the Logs button in the Android app.

#macOS says Chrysalis cannot be opened

macOS blocks downloaded programs that are not notarized. In Terminal, in the unpacked Chrysalis folder:

xattr -dr com.apple.quarantine .

Do this again after each update, since each download is a new folder.

#Windows says it protected your PC

Click More info, then Run anyway. Windows warns about programs that are not signed with a paid certificate.

It is printed in the window where Chrysalis started and written to data/logs/chrysalis.log. On Docker, run docker compose logs chrysalis. Run chrysalis paths to find the data folder. The link stops working once the first account exists.

#I forgot my password

Stop Chrysalis and run chrysalis reset-password <username>. Admins can also set a new password for other accounts in Settings > Users.

#The port is already in use

Another program, or another copy of Chrysalis, is using port 8788. Close it, or start Chrysalis on another port:

./chrysalis --port 8790

To keep the new port, set port in config.yaml.

#My phone cannot connect

  • Check that Allow other devices on my network is on in Settings > Server.
  • Both devices need to be on the same network. Guest Wi-Fi networks often keep devices apart.
  • Allow Chrysalis, or its port, through the computer's firewall. Windows asks the first time it listens on the network.
  • Opening it by a name rather than an IP address? Add that name under Host names.

#The microphone does not work on my phone

Phones only allow the microphone over HTTPS. See HTTPS for the microphone.

#Android stops Chrysalis in the background

Tap Keep running in the background in the Chrysalis app and allow it. Some phones have their own battery savers on top of Android's; allow Chrysalis there too.

#Android will not install the update

See If Android will not install over the old app.

#An app shows a blank page or an error

  • Ask the agent: "the app shows a blank page, find out why". It can read the app's build errors and the errors the page reported.
  • Settings > Developer lists each app's last build.
  • If it started after a change, ask the agent to put the app back the way it was before that change.

#An app update has conflicts

Nothing has changed yet. Pick Keep mine, Take update or Ask the agent to merge; Updating explains each.

#Still stuck

Ask on the Discord, or open an issue with your version, how you run Chrysalis, and the relevant part of the log.

Edit this page on GitHub