> For the complete documentation index, see [llms.txt](https://tgbtc.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tgbtc.gitbook.io/docs/user-guides/testnet-in-ton.md).

# Testnet in TON

Welcome to the world of TON Teleport. 👋

In this article, we’ll guide you through setting up a Testnet wallet on TON.

## 📖 What you will learn

In this guide, you’ll find out how to:

* set up your Testnet wallet using [**Tonkeeper**](https://tonkeeper.com/) or [**TON Space**](https://t.me/wallet/start?startapp)
* get test Toncoins for minting your first tgBTC on the Testnet
* use your Testnet wallet with TON Teleport BTC for test transactions

{% hint style="warning" %}
TON Teleport is currently on Testnet. Do not send real funds and don’t use mainnet.
{% endhint %}

## 🚀 Let's get started!

{% hint style="info" %}
Our colleagues at TON Space (a non-custodial wallet within Telegram) have added support for the TON test network. To switch from mainnet to testnet, go to the [TON Space settings](https://t.me/wallet/start?startapp=tonspace_settings).
{% endhint %}

<figure><img src="/files/2fAz9aH1PIZh0IsaKmTo" alt="" width="311"><figcaption><p>Setting up Testnet in the TON Space settings</p></figcaption></figure>

Setting up a TON testnet wallet is almost the same for both Tonkeeper and TON Space. Let’s continue the guide with Tonkeeper!

### Add a Testnet Account

Use the pre-installed [**Tonkeeper**](https://tonkeeper.com/) on your mobile or PC device. In the Tonkeeper app, tap on your wallet name at the top, then select `Add Wallet` at the bottom. Scroll down and select `Testnet Account`.

<figure><img src="/files/wA352HqJMPjhxrCqkFQI" alt="" width="258"><figcaption></figcaption></figure>

Next, enter your 24-word recovery phrase (or create a new one), then tap `Continue` and make sure to securely save your recovery phrase.

## 💸 How to get test Toncoins

Now that your Testnet wallet is set up, get some Test Toncoins to start minting tgBTC!

{% hint style="info" %}
Test Toncoins have no value and are only used for testing functionality.
{% endhint %}

### Copy your testnet wallet address

Open your Testnet wallet in Tonkeeper and copy your wallet address. You’ll use this to receive test Toncoins.

### Claim test Toncoins via Telegram

Open Telegram and search for the [**@testgiver\_ton\_bot**](https://t.me/testgiver_ton_bot)**.**

Paste your wallet address into the bot to receive free test Toncoins for the Testnet.

<figure><img src="/files/rs16hrMTBMY0Znj076tV" alt="" width="375"><figcaption></figcaption></figure>

## 💡 What's next?

You’ve set up your Testnet TON wallet with an address starting with `0Q...` and received test Toncoins.

* you need to install a Signet BTC wallet to work with test BTC
* choose the setup guide that suits your device: [**PC**](https://tgbtc.gitbook.io/docs/getting-started/signet-in-btc-for-pc) or [**Mobile**](https://tgbtc.gitbook.io/docs/getting-started/signet-in-btc-for-mobile)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://tgbtc.gitbook.io/docs/user-guides/testnet-in-ton.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.