> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firetone.com.au/llms.txt
> Use this file to discover all available pages before exploring further.

# Installing it

> Getting the app onto a phone, and the permissions it asks for.

The app is `au.remotiq.firetone.client` on both stores. Ask your administrator
which build you should be on; a handset one version behind a PBX change is the
commonest cause of a fault that looks like a network problem.

## The first run

The app asks for what it needs on the way in, and explains each one as it asks.
Nothing is requested that is not used.

| It asks for         | Because                                                                      |
| ------------------- | ---------------------------------------------------------------------------- |
| **Microphone**      | Every call. Without it the app cannot place one.                             |
| **Contacts**        | So a caller has a name rather than a number. Read only; nothing is uploaded. |
| **Phone** (Android) | To place carrier calls and to read the system call log.                      |
| **Notifications**   | Missed calls, and the quiet notification that keeps the line up.             |

You can skip the SIP account at this point and add it later. You cannot skip
the microphone and still make calls.

<Note>
  The camera permission string appears in the iPhone's privacy list even though
  FireTone does not use the camera. It is there because the media library the
  app links declares it. Video calling is switched off in this build.
</Note>

## Making it the default phone app

This is worth doing on Android and it is the single biggest difference in how
the app feels. As the default phone app, FireTone answers `tel:` links, shows
the lock-screen call UI, writes to the system call log, and handles carrier
calls with the same screen as FireTone calls.

**Settings › Calling › Default calling app** opens the system prompt. The row
says which app currently holds the role.

On the iPhone there is no equivalent role. iOS 18.2 added a **Default Apps**
list, and the same row will open Settings for you — **Settings › Apps ›
Default Apps › Calling**. Below that version there is nothing to set, and
FireTone works as an ordinary app: you open it to call, and carrier numbers
hand off to the Phone app.

## Keeping the line up

**Settings › Calling › Keep FireTone connected** (Android only) holds the
registration open while the app is closed, so calls ring. It shows a quiet
notification because Android requires one, and it is on by default.

Switch it off and the app only rings while it is open — until push wake-up is
deployed. [What that depends on](/mobile/limitations) is worth reading before
you turn it off.
