Guides › 1 · Install Koberlet › Mac
Install Koberlet on Mac
In about ten minutes you will have Koberlet on your computer and a wallet ready to use: a new one, or the one you already had in another app. You do not need to know anything about crypto; every odd word is explained the first time it shows up.
About 10 minutes · macOS 12 or laterThe screenshots show the app in Spanish. With your computer in English, Koberlet shows the buttons in English, with the names used in the text. You can switch language at any time with the EN / ES button in the app.
When you finish you will have
- Koberlet installed, with its icon on the desktop.
- A password that opens Koberlet on your computer.
- Your wallet: a new one with its 12 words written on paper, or your existing one brought into Koberlet.
In this guide
Words you will see
Tap one to see what it means.
Password and 12 words are not the same thing
Koberlet keeps your keys in an encrypted vault.
Opens with your passwordForgot the password? The 12 words save you.
The same wallet, whole, with the same money.
Rebuilt with the 12 wordsSomeone sees your 12 words? They can take your money from anywhere.
Before you start
- A Mac with macOS 12 or later, Apple silicon or Intel.
- Pen and paper. Really: you are going to write down 12 words, and paper is the safest place for them.
- If you already have a Kadena wallet and want to bring it: its 12 or 24 words at hand.
Download Koberlet
Go to koberlet.dnns.es and scroll down to Downloads. Only download Koberlet from this page: fake copies of wallets made to steal are going around.
Figure 1. The Mac card, in the Downloads section of koberlet.dnns.es. Click Download for Mac (.dmg).
Next to each download there is its SHA-256 fingerprint, in case you want to check the file is the genuine one. The FAQ on the site explains how. It is optional.
Install on Mac
Open the Koberlet-….dmg file you downloaded. A window opens: drag the Koberlet icon onto the Applications folder.
Koberlet→ApplicationsFigure 2. Illustration: drag Koberlet onto the Applications folder. Open Koberlet from Applications or from Launchpad. It is signed and checked by Apple, so it opens without warnings.
The first screen: your password
The first time you open Koberlet it asks for a password. It is used to encrypt the vault, the file where your keys are kept on this computer.
Type a password of at least 8 characters in Password and repeat it in Repeat password. A long sentence you can remember is better than a short word full of symbols.
Figure 3. The first screen: "Create your encrypted vault". In Network for your first wallet leave Kadena (KDA). The other options are for Ethereum and similar networks; they can be added later.
Figure 4. The password typed and the Kadena network selected. Click Create vault and wallet.
The password is not stored anywhere and Koberlet cannot recover it. If you forget it, the only way out is to rebuild the wallet with your 12 words.
From here there are two paths. Is this your first wallet? Go on to A · New wallet. Already have one and want to bring it? Jump to B · Bring your wallet.
A · New wallet
Koberlet shows you your recovery phrase: 12 words. Write them down on paper, in order and numbered 1 to 12. Check them letter by letter before going on.
Figure 5. Your 12 words. They are covered in the screenshot; on your screen you will see them. When you have them on paper, click I wrote it down, continue. This screen never shows up again: Koberlet cannot show you the words a second time.
Koberlet asks for your password to get in. Type it and click Unlock. You will see this screen every time you open the app, and also when it has been idle for a while, because it locks itself for safety.
Figure 6. The screen to get in with your password. The first time, a welcome window shows three tips: write down your recovery phrase, try receiving and start small. All three are explained in these guides. Click Got it, start.
Figure 7. The welcome window. You are now on the Dashboard, the summary of your money. At the top, the total; below, a Kadena card with your wallet, called Mi wallet KDA. For now it is at zero. You will also see a yellow warning, "Low KDA on Kadena… for gas": that is normal with an empty wallet and goes away as soon as you have some KDA.
Figure 8. The dashboard of a freshly created wallet.
- Never take a photo of them or keep them on your phone, email, cloud or WhatsApp. Whoever gets those 12 words takes your money from anywhere in the world.
- Nobody from Koberlet will ever ask for them. If someone does, it is a theft attempt, even if they say they are support.
- Keep the paper where you would keep something valuable. If you like, make a second copy and keep it somewhere else.
B · Bring your wallet
If you already have a Kadena wallet, on another computer, on your phone or in another app such as eckoWallet or Chainweaver, you can bring it with its 12 or 24 words. Your money does not move: Koberlet just learns to use the same keys.
One detail: the first time, Koberlet always creates a new wallet. You will delete it at the end, so you do not need to write its words down, as long as you delete it and never put money in it.
After the password, the phrase of the new wallet appears. Click I wrote it down, continue, get in with your password and click Got it, start in the welcome window (same as in path A).
In the left menu click Wallets and, at the top right, Import.
Figure 9. The Wallets section, with the Import button. In the Import wallet window, leave the Seed tab. Give it a Name (for example "My wallet"), leave Kadena in Network and type your words in the big box, separated by a space.
Figure 10. The "Import wallet" window. Click View this seed's accounts. One phrase can hold several accounts, numbered #0, #1, #2…, and Koberlet shows each one with its balance. Every number appears twice, labelled Chainweaver or eckoWallet: they are two ways of deriving accounts from the same phrase, depending on the app it was created in. Click Import on the one holding your money. It is almost always #0 with the label of the app you come from.
Figure 11. The accounts of the phrase, with their balance. The words are covered in the screenshot. Koberlet takes you to the Dashboard and there is your wallet with its balance. It may take a few seconds to read it from the network.
Figure 12. The dashboard with the imported wallet. All that is left is deleting the wallet created at the start. First check on the Dashboard that Mi wallet KDA is at zero. Then go to Wallets and click its bin 🗑.
Figure 13. Both wallets in Wallets. The one to delete is "Mi wallet KDA". Koberlet asks twice, so nobody deletes anything by mistake. Click Got it, continue and then Yes, delete permanently. Check that the name shown is Mi wallet KDA and not yours.
Figure 14. The confirmation before deleting.
If instead of words you have a private key (a string of 64 letters and numbers), use the Private key tab of the Import window.
If you already used Koberlet on another computer and saved a backup (a .kbk file), on the first screen type that backup's password in Password and click Restore from a backup.
If something goes wrong
I forgot my password
Koberlet does not store it and cannot recover it. If you have your 12 words you lose nothing: you can start from scratch and bring the wallet back. Ask for help in the Telegram group and we will guide you.
I forgot to write down the 12 words
If the wallet is at zero, go to Wallets → Create new, write its words down this time and delete the old one. If it already has money, create the new one anyway, move the money to it (explained in guide 2) and then delete the old one.
I brought my wallet and it shows zero
Go back to Import, click View this seed's accounts and look at the other accounts (#1, #2…): your money may be in another one. If it still does not show up, click ↻ Refresh at the top right.
Can I have the same wallet on my computer and my phone?
Yes. Bring the same 12 words to both and you will see the same wallet and the same money on each.