# Voice over IP setup

Your account supports making phone calls over the Internet -
a.k.a. VoIP.

## Account and sub-accounts

Your "phone number" or VoIP address -
what others use to call you -
is the same as your email address.

You can have multiple "phones" -
places to make and receive calls -
and each has their own sub-account.

Example:

  * Name: Jonas Smedegaard
  * VoIP address: sip:jonas@bitbase.dk
  * Phone account 1: jonas-cellphone
  * Phone account 2: jonas-laptop
  * Phone account 3: jonas-dect


## Setup of a sub-account

Some applications ask for the full address,
some for username and domain separately.


### CSipSimple on Android

 1. Install csipsimple from f-droid.
 2. Select "Use sip account"
    * Enter username, password, "bitbase.dk", your full name (as display name).
    * Leave "Transport" set to the default "TLS".
    * Click "Login"
 3. Select "Settings" from main menu.
    * Select "Network" submenu.
    * Select "Media Encryption" and choose ZRTP.
 4. Optionally: Select "advanced" and "start at boot".


## Making a call

When your VoIP application is active,
and registration with our server succeeds
(see [setup]),
you can initiate phone calls.

### Test services

Here are some test services you can try call:

  * echo (or 9876): Repeats what you say, after a brief delay
  * time: speaks the current time at the phone server
  * helloworld: speaks "Hello World"
  * recordsample: records what you say...
  * playbacksample: plays back the most recently recorded sample


## Receiving a call

To receive calls,
your VoIP application is active and registered continuously.

Beware esp. on mobile devices
that having VoIP active drains more battery.