Set up your line
This connects a number you already own to the app. It takes about a minute, and you only do it once.
Who carries your number?
Gerany Phone works with either. Pick the provider your number is with — the account, the number and the bill stay yours in both cases.
Get a key from Telnyx
Open portal.telnyx.com → API Keys and create one.
Set it to expire in 1 hour. A Telnyx key has full access to your account — it can buy numbers and spend money — and Telnyx does not offer a limited one. An hour is far longer than this page needs and means a key that leaks anywhere is dead before it is useful.
Paste it below. It is used only for the requests that set your line up, it is never written to disk or logged, and nothing about it is kept once this page is done. You can delete it on that same page afterwards.
Choose your number
This is the number people will see when you call them.
Get your Twilio credentials
Open console.twilio.com. Your Account SID and Auth Token are on the front page, under Account Info.
The Auth Token has full access to your Twilio account. It is used here only to create a limited API key for your phone, and it is never written to disk or logged. Once this page is done, nothing about it is kept — and you can roll it in the console afterwards if you would rather.
What this page makes on your account: an API key for the app to sign in with, a push credential so calls can wake your phone, and a TwiML app that points your number at Gerany Phone.
It has to be a Main key. Twilio Console →
Account → API keys & tokens → Create API key, and set Key type
to Main. Twilio shows the secret once, so copy it before
you close the dialog.
Neither of the narrower kinds can do this job, and that is Twilio's rule:
a Standard key is blocked from the Keys resource, so it cannot
create the key your phone signs in with; a Restricted key has no
permission for creating a TwiML app or a push credential, which this page
also has to do.
Delete the Main key as soon as this page is finished. It
is needed for about thirty seconds and never again — Gerany Phone is given a
separate, narrower key of its own. A Main key deleted straight afterwards
is far less exposure than an Auth Token you have to keep.
Simpler, but the Auth Token is full access to your whole Twilio account. It is used here for one request and never stored, and you can roll it in the console afterwards.
Choose your number
This is the number people will see when you call them. Gerany Phone points it at itself, so calls to it ring on your phone.
If this number is already set up for Gerany Phone, it is attached to this phone rather than configured again: nothing on your Twilio account changes except one new API key for the device. Setting the same number up on a second phone is the ordinary case, not an odd one.
Finish voicemail setup
Gerany Phone on your phone is ready for . One thing is left: your Telnyx API key, used once to turn on voicemail (and recording, if you chose it) and to tell Telnyx where to send notifications. It is never stored.
Your line is ready
Open this on the iPhone or iPad with Gerany Phone installed and it will fill itself in.
Voicemail is on for this number. Calls you miss or decline are recorded by your provider, and Gerany Phone is told so it can notify you and transcribe the message on your phone.
To listen the old-fashioned way, call *98 from this line and enter the PIN. The app shows it under Settings ▸ the line.
Now delete the Main API key you used. Twilio Console → Account → API keys & tokens → delete it. Gerany Phone never needs it again: your phone has its own separate key, and this page keeps nothing. If you used your Auth Token instead, roll it there for the same reason.
Set this up on a computer, or on another phone? Open Gerany Phone, go to Settings ▸ Lines ▸ Enter a setup code, and type this in:
Good for ten minutes, once. Your password is not on this page and never travels in a link — the app fetches it with the code, and the code dies the moment it is used.
Or type it in by hand, under Settings → Add line: