> For the complete documentation index, see [llms.txt](https://docs.goodcrypto.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.goodcrypto.app/goodcryptox-3.0/readme/phone-access.md).

# Phone access

goodcryptoX runs on your Mac, NAS or server; your phone and your other computers connect to it and see and do everything.

goodcryptoX does not run on your phone. It runs on your Mac, NAS or server, and your phone connects to it at my.goodcrypto.app: it sees and does everything. Your other computers connect the same way.

At home, [add your phone at the machine's own address](https://docs.goodcrypto.app/goodcryptox-3.0/readme/set-up-on-your-mac.md#your-home-network) to open goodcryptoX without our relay; the steps below use our relay, which also works away from home. A wallet connects at the home address as it does anywhere else; a phone wallet scans the QR code.

If you open the home network address in a browser that has not been added, the page says: "To open goodcryptoX in this browser, use the home link from Settings › Devices on a device where it is open."

## Pair a device

On a device that is already in, open Settings › Devices › **Add a device**. It shows a QR code, and under it the same link with **Copy**. Scan the code with your phone's camera, or open the link on the other device, and confirm once with Face ID, Touch ID or the device's own unlock.

From then on, the device opens goodcryptoX at my.goodcrypto.app, from its bookmark or home-screen icon, and signs in the same way, no link, no code.

For an alert's **Open** link, see [Opening goodcryptoX from a message](https://docs.goodcrypto.app/goodcryptox-3.0/readme/telegram-alerts.md#opening-goodcryptox-from-a-message), including Telegram's one-time browser setting.

The link works once: it dies the moment a device uses it. It also expires after 10 minutes; for a fresh one, press **Add a device** again. On a server, the first device comes from the link in its log ([Sign in](https://docs.goodcrypto.app/goodcryptox-3.0/readme/set-up-on-a-server.md#sign-in)).

A passkey saved in iCloud or Google already works on your other devices in the same account, so a new iPhone on the same Apple ID often needs nothing at all; such a device has the rights of the one whose passkey it shares.

## The shortest way

* **A Mac, then your phone.** [Set up on your Mac](https://docs.goodcrypto.app/goodcryptox-3.0/readme/set-up-on-your-mac.md), then on the Mac open Settings › Devices › **Add a device** and scan the code with your phone.
* **A server, then only your phone.** [Set up on a server](https://docs.goodcrypto.app/goodcryptox-3.0/readme/set-up-on-a-server.md) and add your phone. Once your phone is added, no computer is needed: you can run everything from it.
* **A server, with your Mac and your phone.** Open the server's first link on the Mac, then add the phone from the Mac. If the phone came first, open my.goodcrypto.app on the Mac: a passkey from iCloud signs you in; if not, press **Add a device** on the phone and open its link on the Mac.
* **Another computer.** **Add a device** on a device that is in, **Copy**, and open the link on the new computer.

## Each device is a key

Each device in the list has a switch: **Can trade** does everything you can; **Read-only** only looks. Give a shared or borrowed phone Read-only. Removing a device is a row in the same Settings list; it stops within a second.

There is no other limit. Your keys never leave the machine goodcryptoX runs on. A device keeps goodcryptoX's own code after its first visit, so later visits open faster.

## The menu on a phone

On a phone the menu is a bar at the bottom of the screen with three pages: Dashboard, Trade and Settings. The Documentation book is at the top right of the Dashboard and of Settings and its pages.

## On the home screen

goodcryptoX is not an app from a store. Saved to your home screen, it opens and feels like one, full screen, with no browser bar. After the phone sleeps, it comes back by itself.

<details>

<summary>On an iPhone, step by step</summary>

**1.** Open my.goodcrypto.app in Safari and press the three lines at the left of the address bar.

<figure><img src="https://3159525366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fa2N3UpsDMTXUeIHBCQgd%2F01-menu.webp?alt=media" alt="The address bar&#x27;s menu, the arrow at the three lines" width="300"><figcaption></figcaption></figure>

**2.** Press **Share**.

<figure><img src="https://3159525366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FuagUINfMuRLaU2Utcjyg%2F02-share.webp?alt=media" alt="The menu, the arrow at Share" width="300"><figcaption></figcaption></figure>

**3.** Press **View More**.

<figure><img src="https://3159525366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FIHcrKuXI3KojIncm9FWH%2F03-view-more.webp?alt=media" alt="The share sheet, the arrow at View More" width="563"><figcaption></figcaption></figure>

**4.** Press **Add to Home Screen**.

<figure><img src="https://3159525366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FolfRVFfTZx9ocuEMSZBD%2F04-add-to-home-screen.webp?alt=media" alt="The arrow at Add to Home Screen" width="300"><figcaption></figcaption></figure>

**5.** Leave **Open as Web App** on, keep the name **goodcryptoX**, and press **Add**.

<figure><img src="https://3159525366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FTt6EXQvcIpcYInOiMv4K%2F05-open-as-web-app.webp?alt=media" alt="The arrow at Open as Web App, left on, and at Add" width="300"><figcaption></figcaption></figure>

The icon then works from your home screen, even from the dock, just like the old goodcryptoX app.

</details>

On Android, press **Install** on the card goodcryptoX shows you at the top of the Dashboard: the browser opens its install sheet at once. Close the card with its cross and it waits in Settings › General, until you install or close it there too.

If you do not see the card, or you closed it, use the browser's menu: open it (the three dots) and press **Install and create shortcut**. The first time, the menu may say **Add to Home screen** instead; that works too.

<figure><img src="https://3159525366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FwX0gnzO4tXuW8Y2Ky8BV%2Fandroid-01-install.webp?alt=media" alt="Install and create shortcut in Chrome&#x27;s menu" width="300"><figcaption></figcaption></figure>

When Chrome offers **Install goodcryptoX** at the top of the page by itself, press **Install**: it is the same thing.

<figure><img src="https://3159525366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FjIQdbIevi4lxB3GnKIyv%2Fandroid-02-install-bar.webp?alt=media" alt="Chrome&#x27;s own Install goodcryptoX bar" width="300"><figcaption></figcaption></figure>

On some phones (Samsung among them) the installed goodcryptoX lands in the apps list, not on the home screen: hold its icon there and choose **Add to Home screen**.

## Questions

### Is there a goodcryptoX app for my phone?

goodcryptoX is not an app from a store: it runs on your Mac, NAS or server, and your phone opens it at my.goodcrypto.app. Saved to your home screen, it opens and feels like one, full screen, with no browser bar.

### How do I add my phone?

On a device that is already in, open Settings › Devices › **Add a device** and scan its QR code with your phone's camera. Confirm once with Face ID, Touch ID or the phone's own unlock.

### Can I run goodcryptoX from my phone alone?

Yes: [set it up on a server](https://docs.goodcrypto.app/goodcryptox-3.0/readme/set-up-on-a-server.md) and add your phone. Once your phone is added, no computer is needed: you can run everything from it.

### Can I give a phone read-only access?

Yes: each device in Settings › Devices has a switch, **Can trade** or **Read-only**. Give a shared or borrowed phone Read-only.

### Do my keys go to my phone?

No: your keys never leave the machine goodcryptoX runs on.
