Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/jossephus/chuchu/llms.txt

Use this file to discover all available pages before exploring further.

Chuchu supports Transport.TailscaleSSH as a first-class transport option. Under the hood it uses the same libssh2 SSH stack as a standard connection, but targets your machine’s Tailscale IP or hostname instead of a public address. Before dialing, Chuchu verifies that Tailscale is active on your Android device — if it isn’t, the connection attempt fails immediately with a clear error rather than timing out.

Prerequisites

  • Tailscale installed on your Android device — download the Tailscale app from the Play Store and sign in to your tailnet.
  • Tailscale SSH enabled on the target machine — run tailscale ssh enable on the remote host, or ensure your Tailscale ACLs grant SSH access to your device.

Connect via Tailscale

1

Install and start Tailscale on Android

Install the Tailscale app, sign in, and ensure it is running. Chuchu checks for a Tailscale network address (100.64.0.0/10) on your device before connecting.
2

Enable Tailscale SSH on the target machine

On the remote host, run:
tailscale ssh enable
Alternatively, configure your Tailscale ACL policy to allow SSH from your device to the target machine.
3

Add a new server in Chuchu

Tap + on the server list screen. Set Host to the machine’s Tailscale hostname or IP address — for example my-server or 100.x.x.x.
4

Set the transport

Set Transport to Tailscale SSH.
5

Choose an auth method and save

Select your authentication method (password or key) and fill in the relevant credentials, then tap Save.
6

Connect

Tap the server. Chuchu checks Tailscale status first, then dials over your tailnet.
Tailscale SSH can be configured via ACLs to bypass traditional key-based auth for machines on your tailnet. Even so, the auth method you configure in Chuchu still applies — Chuchu authenticates using whichever method you selected when adding the server profile.
Tailscale must be running on your Android device when you connect. Chuchu checks for an active Tailscale network interface before dialing, and will error immediately if Tailscale is not active.

Build docs developers (and LLMs) love