Joining BeanPool

Two ways in: a community, with an invite from a member, or the global community when it is open, with 12 secret words or one sign-in. Asking a community to let you in, and how to invite someone else.

Two ways in

With an invite, you join a community: the people near you, with its own Beans, trades and Commons. A member of that community invites you.
Without an invite, you can join the global community when it is open: people from everywhere, where you can post, message people and find a community near you. There are no Beans and no community votes there. Beans, credit, the Commons and its Decisions live in local communities.

No invite, but a community near you? Join the global community, then ask that community to let you in: any of its members can, or, in a community where only the admins invite, its admins. See "Finding a community near you".

Either way, your account is a key kept on your phone, with 12 words that bring it back. There is no password.

Joining with an invite

An invite is a link, a QR code or a code. A code looks like INV- followed by letters, or a long code that starts with BP-.

An invite works once.
An invite lasts 30 days. After that, ask for a new one.

To join:

Install BeanPool and open it. If you tap an invite link first, the app picks up the invite by itself, even straight after installing it from Google Play.
On the first screen, tap Join with an invite. If the invite is on your clipboard, you can tap Paste instead. In the web app, the button says I'm New Here.
Paste the invite link or code. If you only have a code, also type the community's name or address. The person who invited you can tell you.
Choose the name people will see. It needs at least 2 letters. Keep it short: when you join, names longer than 20 characters are cut short.
Tap Next. The app checks the invite and the name. If someone already has that name, it suggests others. Until it has finished, ← Back to Home and Restore Existing Identity don't work.

Joining the global community

You can join in the phone app or in a web browser. In a browser, open global.beanpool.org and tap Join: see "Using BeanPool in a web browser" for the steps. In the phone app:

On the first screen, tap Explore BeanPool worldwide. It is at the bottom of the screen: on a small phone, scroll down. The app shows it only when the global community is open.
Choose one of the two ways in, side by side. Create an account with 12 secret words needs no Google, Apple or Facebook account: your 12 words are the only way back in.
Or sign in once with Google, Apple (on an iPhone) or Facebook. That sign-in is also a way back if you lose your phone. BeanPool never sees your password and never posts anything for you.
Choose the name people will see, up to 20 characters, and tap Join. If someone already has that name, the app suggests others.

With 12 words, your phone also does a moment of work to set up the account. It starts as soon as the two ways show, while you read and type your name, so most people never wait for it. If you tap Join before it is done, the app says Setting up your account… with a bar, and ← Back still works. When a lot of people are joining from your network, the app says so, with how long it will take on your phone, and you can sign in instead to join at once. A sign-in join is asked for this work only on a very busy network, and the app does it by itself. Choose another way stops the waiting and takes you back to the two ways. If you sign in instead, the 12-words setting up stops to save your battery, and Choose another way starts it again.

If the community says to wait (too many people joining from your network), the app says how long. Tapping Join before then only says it again, with the time left; after the wait, or after a minute if the wait is longer, Join asks again. If your phone's date and time are wrong, the app says Check them in your phone's settings (set them to automatic), then try again. If the community closed your account (you deleted it, or you were removed), the app says This account's place in the global community was closed, so it can't join again. and doesn't offer the door to it again.

If a 12-words join, in the phone app or in a web browser, says the community couldn't accept it because your date and time look wrong, the clock on that phone or computer is more than a few minutes off. Set its date and time to automatic in its settings, then try again. Nothing was saved, and signing in again won't help. The same words appear if adding a sign-in or getting your account back in a browser is refused for the same reason.

If you sign in, the community keeps only a scrambled reference to your sign-in account, never your email. That sign-in also becomes a way back into your account if you lose your phone, so you are not asked to sign in again at Safety Backup. For that, the community keeps a locked copy of your account. The people who run its server can open that copy: see "Getting your account back". After joining you don't sign in to open the app: your account is the key on your phone, like any other.

If you join with 12 words, nothing about you reaches the community but your key and your name, and your 12 words are your only way back: nobody can reset them, not BeanPool and not the community. Safety Backup says so, and offers Add a sign-in as a second way back. After joining, a card on Home says Your account has one way back: your 12 words. Check you still have them, or add a sign-in. Tap ✕ to put it away: it comes back once after your first post and once after a week, then stays in Settings, under Account Protection, until you add a sign-in or tap I still have my 12 words. An account made with 12 words also has smaller limits for its first 7 days, and until 3 of its posts have stayed up: 2 posts, 4 photos and 3 new people to message a day, and one report hides its post while it is new. Adding a sign-in, any time, lifts it to the usual new-account limits. You can add one from any phone where you are in your account, not only the one you joined on. If BeanPool's key vault already keeps a copy of your account, the card is not shown, and Settings offers Add a sign-in quietly.

Already have an account? Join the global community with it, not with a second one. Tap the bean at the top left and, under Your communities, tap Join the global community. If you are visiting the global community as a guest, tap Join at the top, next to the bean, then Join with a sign-in. You join with your 12 words or sign in once, check your name and tap Join. Your key and your 12 words stay the same, and nothing changes in your other communities. See "More than one community".

The four steps

The bar at the top shows Your Name, Your Photo, Safety Backup and How it Works.

Your Photo: choose a photo or one of the ready-made pictures. You must pick one before Next works. People trade more easily with a face or a picture they recognise.
← Back on Your Photo takes you back to your name, to change it. It is still the same account: tap Next and you carry on to Your Photo and Safety Backup with the new name. If someone already has it, the app suggests others.
Safety Backup: the app shows your 12 words. Write them down on paper and keep them safe. The tickbox I've saved these words is there to remind you. Nothing stops you if you skip it, but read "Your 12 words" soon. If you joined the global community with a sign-in, this step also shows your sign-in protecting your account. If you joined it with 12 words, it says first that these 12 words are your account, and offers Add a sign-in as a second way back: you can skip that too.
How it Works: a short tour. Tap Let's Begin! to start.

If you close the app halfway, it carries on from the same step next time.

If the invite does not work

Already used: each invite works exactly once. Ask for a new one. If it was yours and you are already a member, use Recover an existing account instead.
Expired: invites last 30 days. Ask for a new one.
Not recognised: check you copied all of it, and that the community name or address is right.
Made by a member, and only the admins bring people in now: the community has chosen that only its admins invite, and a ticket a member made without a connection no longer works. Ask an admin for a fresh invite.
Failed to register identity (after you tap Next): usually no connection, or no answer in time. Check your connection and tap Next again. If your first try got through, the app carries on to Your Photo and Safety Backup with the same account.

If joining the global community does not work

No Explore BeanPool worldwide button: the global community isn't open yet, or the app couldn't reach it. Check your connection and open the app again. You can still join a community with an invite.
Can't reach the global community: check your connection and tap Try again. You can still join a community with an invite.
The global community didn't answer in time (after you tap Join): your name wasn't checked and nothing was sent. Check your connection and tap Join again, or go back. While the app is checking your name, Use a different sign-in and ← Back to Home still work.
This sign-in already has a BeanPool identity: you joined before, perhaps on another phone. Tap Restore my account, then use your 12 words or the same sign-in.
This sign-in already joined the global community with a different BeanPool account (joining from the account on your phone): that sign-in has its own account there. Tap Use a different sign-in.
This community can't check sign-ins right now: the global community has moved to another server and can't yet tell a returning account from a new one, so for now it takes nobody new this way. Nothing was saved. Try again later.
Too many new accounts from this network: there is a limit on new accounts from one internet connection. Everyone on the same network counts together, so at a campus, an office or a meetup it may be other people joining, not you. Try again later.
Not taking new members right now: join a community with an invite instead.

Inviting someone

Any member can invite people, unless the community has chosen that only its admins do (see below). Your trust badge does not matter.

Tap the invite icon (a person with a plus) at the top right of the screen. This opens Invites.
If you like, write who the invite is for, just for your own records.
Tap Generate Ticket. Without a connection, the button says Generate Offline Ticket, and that works too.
Show them the QR code, or tap Share Invite to send the link and the code.
Invites nobody has used yet are listed under Pending, each with Share to send it again.
You can make 20 invites a day, and have 50 that nobody has used yet. An invite nobody uses is deleted after its 30 days, and leaves Pending.

A community's admins can turn invites off for the whole community.

Where only the admins invite. A community can choose that only its owners and admins bring people in. There, if you are not one of them, Invites shows Bring someone here instead of Generate Ticket, and says to ask an admin. On the web app the Tree stays, and so do the codes you made earlier: they still work until they lapse. An owner or admin with no signal can still make a paper ticket, from the last role the community gave them. If the community takes requests to join, Share the link sends its address: the person opens it in the BeanPool app, asks to join, and an admin answers. Being an admin is a job the community gives someone, not a trust badge.

Invite codes you made before the community chose this still work until their 30 days are up.
A ticket you made without a connection doesn't: whoever has it is asked to get a fresh invite from an admin.

The global community has no invites: anyone joins it with a sign-in, one account each. There, the invite icon opens Bring someone here, with Share the link to send the global community's address. There is nothing to generate, and an invite code made for it does not work.

Requests to join

People can ask to join your community from the global community. When someone has, Invites shows a count, and the requests are listed at the top under Wants to join.

Invite makes an invite that only their account can use. Their app finds it by itself, so you don't send them anything, and they join with one tap.
Not now tells them nothing more than "no answer yet".

Any member can answer. In a community where only the admins invite, only its owners and admins see the requests and answer them. See "Finding a community near you".

The same guide is in the BeanPool app, and works there without a connection: open Settings, then "Help & how it works" under BeanPool. Every other rule, guide and manual is in the Help Centre. Guide version 112.