Use it from your phone

There are three ways to use Chrysalis on a phone. Pick the one that fits.

#Chrysalis on your computer, phone on the same Wi-Fi

1. On the computer, open Settings > Server. Only the admin account sees this tab.
2. Turn on Allow other devices on my network. It applies right away.
3. If a firewall note appears under the QR code, press Allow on this network and type the computer's password when it asks. This lets devices on your local network reach Chrysalis and the apps that run their own program. It never opens them to the internet.
4. Scan the QR code with your phone's camera, or type the address shown under it.

Every account still needs its password from the phone. If the phone cannot connect, check that both devices are on the same network.

The firewall note only shows when Chrysalis finds a firewall it knows on that computer. The password prompt appears on the computer running Chrysalis, even when you press the button from another device. If the prompt cannot be shown there, the page gives a command to run on that computer instead. Chrysalis uses its own port and the 16 after it (8788 to 8804 unless you changed the port).

#Away from home

Put the computer and the phone on the same private network with Tailscale, then open the computer's Tailscale address on the phone. If you use its Tailscale name rather than the IP address, add that name under Host names in Settings > Server.

#HTTPS for the microphone and installing as an app

Phones only allow the microphone, and adding a site to the home screen as an app, over HTTPS. To serve Chrysalis over HTTPS you need a certificate and key file for the address you open it by. With Tailscale:

tailscale cert my-computer.tailnet-name.ts.net

Then in Settings > Server, turn on Use HTTPS and fill in Certificate and Key with the two files it wrote. The same settings are ssl.certPath and ssl.keyPath in config.yaml.

#Chrysalis on the phone itself

Install the Android app. It runs the whole server on the phone and opens it in your browser, so it works with no computer and no network.

• Tap Keep running in the background, or Android may pause the server while you are in the browser.
• Stop shuts the server down; Open Chrysalis opens it again in the browser.
• Logs shows the latest 400 lines from the current server run, with colors for warnings and errors. Scroll up to read without following new output. Copy copies plain text for bug reports.
• Your data lives inside the app. Uninstalling deletes it, so download a backup or move it to another device first.