| page_ref | /docs/apps/termux/index.html |
|---|
Welcome to the Termux app documentation.
Termux may be unstable on Android 12 and higher. The OS aggressively terminates "phantom processes" (limit of 32 system-wide) and processes using excessive CPU. This can cause sessions to end with [Process completed (signal 9) — press Enter].
- Related: issue #2366, Android issue tracker
- A proper docs page is planned. Android 12L/13 may provide options to disable this behavior.
Set the log level in Termux app settings → Debugging → Log Level (requires v0.118.0+).
| Level | Description |
|---|---|
| Off | No logging |
| Normal | Errors, warnings, info, stacktraces |
| Debug | Debug-level messages |
| Verbose | All information (may include private data) |
Revert to Normal after debugging. Verbose mode may expose private data to logcat and increases execution time.
Plugin apps send execution intents to the main Termux app. Set log levels for both the plugin and the main app to get full info.
- In Termux:
logcatfor realtime output, orlogcat -d > logcat.txtfor a dump - From PC: Use
logcatvia ADB. See the Android logcat guide
Long-hold the terminal → More → Report Issue to generate a debug report with file stats and logcat dump.
- Post the complete report as text when filing issues
- Issues with screenshots of reports instead of text will be closed
- If the report is too large, use Save To File (3-dot menu) to share it