OpenCode Mobile is a community-built Android and iOS client for an [OpenCode](https://opencode.ai/) server that you run yourself. This documentation covers installing the app, connecting it to your server, configuring providers, securing remote access, and fixing connection problems.

OpenCode Mobile is **not** an official OpenCode product, a hosted AI service, or a replacement for the OpenCode server.

## Start here

- **[Download OpenCode Mobile](/download/)** — Google Play, direct APK, or the iOS TestFlight beta.
- **[What is OpenCode Mobile?](/docs/introduction/)** — the client, its main screens, and its limits.
- **[Set up OpenCode Mobile](/docs/getting-started/)** — the shortest safe path to a first completed task.
- **[OpenCode Mobile app setup and download](/docs/opencode-android-app/)** — requirements and connection options.
- **[User manual](/docs/user-manual/)** — the navigation hub for operating the app.

## Do a specific task

- **[Choose a workflow guide](/docs/features/)** — start with the outcome you need.
- **[Start and monitor tasks](/docs/guides/tasks/)**
- **[Manage sessions](/docs/guides/sessions/)**
- **[Approvals and changes](/docs/guides/approvals-and-changes/)**
- **[Voice mode](/docs/guides/voice/)**
- **[Understand session usage](/docs/guides/usage/)**
- **[Work with files](/docs/guides/workspace-files/)**
- **[Use the terminal](/docs/guides/terminal/)**
- **[Manage worktrees](/docs/guides/worktrees/)**
- **[Providers and models](/docs/guides/providers-and-models/)**
- **[MCP and diagnostics](/docs/guides/mcp-and-diagnostics/)**
- **[Task notifications](/docs/guides/notifications/)**

## Reach your server

- **[Remote access overview](/docs/remote-access/)** — compare LAN, Tailscale, Cloudflare Tunnel, reverse proxy, and SSH forwarding.
- **[Use OpenCode from your phone](/docs/guides/use-opencode-from-phone/)**
- **[Connect with Tailscale](/docs/guides/tailscale/)**
- **[Connect with Cloudflare Tunnel](/docs/guides/cloudflare-tunnel/)**
- **[Secure remote access](/docs/guides/remote-access-security/)**
- **[Mobile vs web](/docs/guides/mobile-vs-web/)**

## How the pieces fit

| Piece | What it is | Where it runs |
| --- | --- | --- |
| OpenCode Mobile | The mobile client you install | Android or iOS |
| OpenCode server | The coding agent that owns your project | Your machine |
| Connection route | LAN, VPN, tunnel, proxy, or SSH forward | Between the two |

The app is a remote control. Your repository, provider credentials, build tools, and complete development environment stay on the machine that runs OpenCode.

## Fix a problem

- **[Troubleshoot connection problems](/docs/guides/troubleshooting/)**
- **[FAQ](/docs/faq/)**
- **[Releases and compatibility](/docs/changelog/)**