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.

This guide walks you through adding a server to Chuchu and opening your first terminal session. By the end you will have a live SSH connection and know how to use the terminal’s accessory key bar for keyboard shortcuts.

​
Connect to your first server

1

Open Chuchu

Launch Chuchu from your app drawer. On first launch the server list is empty and shows a no hosts configured message. This is your starting point.
2

Tap + add server

Tap the + add server button in the bottom-right corner to open the add server form.
3

Fill in the connection details

Enter the following fields under the CONNECTION section:
  • Name — a label for this server (e.g., home server)
  • Host — the IP address or hostname (e.g., 192.168.1.10)
  • Port — defaults to 22; change this if your server runs SSH on a different port
  • Username — your login name on the remote host (e.g., root or your user account)
Under TRANSPORT, choose how to reach the server:
  • ssh — standard SSH over TCP (the default for most servers)
  • tailscale — connect through your Tailscale network using a Tailscale IP (100.x.x.x) or MagicDNS name
  • mosh — UDP-based transport; best for high-latency or unreliable networks
4

Choose an authentication method

Under AUTHENTICATION, select how you want to log in:
  • Password — enter your account password. Simple and works immediately.
  • SSH key — more secure. If you don’t have a key yet, tap generate key to create an Ed25519 key pair on-device. Then copy the public key and add it to ~/.ssh/authorized_keys on the remote host. You can optionally protect the key with a passphrase.
SSH key authentication is recommended over passwords. Generated keys are stored securely on your device and never leave it in unencrypted form.
5

Save the server

Scroll down and tap save. You can optionally tap test connection first to verify that the host and credentials are reachable before saving.
6

Tap the server card to connect

Back on the server list, tap your new server card (or tap the connect button on the card). Chuchu will begin establishing the connection.
7

Review and accept the host key fingerprint

On your very first connection to a host, Chuchu shows you the server’s public key fingerprint (SHA-256). Verify this matches the fingerprint of your server — you can check it on the server itself by running:
ssh-keygen -l -f /etc/ssh/ssh_host_ed25519_key.pub
Tap Accept to trust the key and continue. Chuchu stores the fingerprint and will alert you if it ever changes.
8

You're in a terminal session

The terminal opens and you are logged in. Use the accessory key bar above the keyboard for keys that are hard to type on a touchscreen — Ctrl, Esc, Tab, arrow keys, and function keys. Swipe the bar horizontally to see more keys.

​
What’s next?

SSH keys

Generate and manage on-device Ed25519 keys for all your servers.

Themes

Pick from 400+ themes sourced from the Ghostty theme repository.

Security

Enable biometric lock and per-connection authentication requirements.

Tailscale SSH

Connect to machines on your Tailscale network without opening firewall ports.

Build docs developers (and LLMs) love

Get started for freeTalk to us