Contact & Support
Happy to help. Whether you hit a bug, have a question, or want to suggest a feature, reach out and we'll do our best to get you unstuck.
Get help
There are two good ways to reach us:
- Email — okdohyuk@gmail.com for questions, feedback, and support.
- GitHub — open an issue at github.com/okdohyuk/muxpad to report a bug or request a feature. Public issues help other users too.
Before writing in, a quick look at the setup & docs page solves many first-connection questions.
Filing a good bug report
The more detail you include, the faster we can reproduce and fix it. Please tell us:
- Your device & OS — iPhone/iPad model and iOS/iPadOS version (Settings › General › About).
- MuxPad version — shown in the app's settings.
- Your server — the server OS/distribution and the output of
tmux -V. - Steps to reproduce — exactly what you did, what you expected, and what actually happened.
- Extras — a screenshot or screen recording if the issue is visual.
A copy-paste template:
MuxPad version:
Device / iOS version:
Server OS:
tmux -V output:
Steps to reproduce:
What I expected:
What actually happened:
Please don't include passwords, private keys, or other secrets in a report.
FAQ
- Do I need tmux on the server? Yes. MuxPad renders your server's tmux exactly as-is over SSH (100% raw tmux) — there is no local shell emulation. It auto-detects tmux on connect and, if it's missing, blocks the connection and shows installation guidance. tmux 3.2 or newer is recommended.
- Will it change my tmux setup? No. Your prefix, key bindings, and status bar all stay. MuxPad passes keys through raw and shows tmux as it runs on the server — it does not impose its own tabs or panes.
- Can I hand files to a remote CLI? Yes. Drop or paste an image or file onto the terminal and MuxPad auto-uploads it over SFTP, then inserts the remote path at your prompt — handy for tools like Claude Code. There is also a dual-pane SFTP file manager with resume and conflict handling.
- Are my passwords sent anywhere? No. Credentials (passwords, private keys, passphrases) are stored only in your device Keychain. With iCloud sync on, they sync between your own devices via Apple's end-to-end encrypted iCloud Keychain. They are never sent to the developer and never stored in CloudKit metadata — only an opaque reference is synced.
- Which auth methods are supported? Password, ed25519 keys, and RSA keys, with known_hosts fingerprint verification and host chaining (ProxyJump) through a jump host.
- Does it work on iPhone? Yes. MuxPad is iPad-first but fully supported on iPhone, and because tmux sessions live on the server you can start a session on iPad and continue it on iPhone.
Still stuck? Email us — we read every message.