Hiroba Blog

Getting Started with Hiroba: Create an Account, Set Up Your Organization, and Invite Your Team

This guide walks through setting up Hiroba, with a screenshot of each screen along the way. There are four steps: install the app, sign in, create your organization, and invite your teammates. The whole thing takes about ten minutes, and the people you invite don't need to install anything. They can join the same office from their browser.

1. Install the app

Start by installing Hiroba on the computer of whoever is setting up the office. On Windows, get it from the Microsoft Store. On a Mac, get the installer from the download section, or install it from the command line: run brew tap ludo-technologies/hiroba, then brew trust ludo-technologies/hiroba, then brew install --cask hiroba. (On Homebrew versions before 6, skip brew trust.)

Updates are automatic, so you only install it once.

2. Sign in

When you open the app, you'll see the sign-in screen. There are three ways to sign in:

  • A Google account
  • A GitHub account
  • An email address (you'll enter a 6-digit code we send you)

This guide uses an email address. Type it in and click "Email me a code".

Hiroba's sign-in screen. Below the Sign in with Google and Sign in with GitHub buttons there is an email address field and an Email me a code button.
The sign-in screen. Email sign-in sits below the Google and GitHub buttons.

At the bottom of the sign-in screen you can also set your display name and avatar color. Your display name is what teammates see in the office, and you can change it at any time.

You'll receive an email titled "Your Hiroba login code". Enter the 6-digit code from it. Sign-in continues on its own as soon as all six digits are in. The code expires after 10 minutes. If it doesn't arrive, check your spam folder or click "Send another code".

The login code screen: a prompt to enter the 6-digit code sent to the email address, a code field, a Sign in button, and Send another code and Use a different address buttons.
Enter the 6-digit code from the email.

3. Create your organization

The first time you sign in, Hiroba asks you to name your organization. An organization is the office your team shares. Enter your company or team name and click "Create organization".

The Name your organization screen with Acme Inc entered as the organization name and a Create organization button below it. Further down is the note Invited to an existing organization? Open your invite link in the browser and sign in there, and a Back to sign-in button.
Name your organization and click "Create organization".

Creating the organization starts your 30-day free trial automatically. There's no card to enter, and no limit on people or features during the trial.

If a teammate has already invited you, you don't need to create an organization. Open the invite link in your browser and sign in there (see 7. How invited teammates join). Once you've joined, this screen closes by itself and you're in the office.

4. Invite your teammates

Right after the organization is created, you'll see "Invite your teammates". Enter the email addresses of the people you want to invite and click "Send email invites", and each of them gets an email with a link to join. To invite several people at once, separate the addresses with commas, like [email protected], [email protected].

The Invite your teammates screen with an email address entered, followed by a Send email invites button, a Copy an invite link to share yourself button, and an Enter the office button.
Enter email addresses and click "Send email invites".

Once the invites are sent, a confirmation appears under the button and "Enter the office" at the bottom becomes the main button.

The invite screen after sending: the message Invites sent to ren@example.com appears under the Send email invites button, and the Enter the office button at the bottom is now highlighted.
After sending. You can invite more people from the same screen.

If you'd rather share the invitation in Slack or another chat, click "Copy an invite link to share yourself" and paste the link there. The same link works for everyone, so one is enough. You can always invite people later, so there's no need to invite everyone now.

5. Enter the office

Click "Enter the office" to step into your new office. The sidebar on the left shows your organization's name, the days left in your trial, and who's here. For now, that's just you.

The Hiroba office right after entering: an isometric office with desks, a glass meeting room, a lounge, and a café counter, and your avatar in the middle of the floor. The sidebar shows the organization name Acme Inc, Free trial: 30 days left, your name, and an Invite members button.
The office right after you enter. Teammates appear in the sidebar and on the floor as they join.

Move your avatar with WASD or the arrow keys, or click anywhere on the floor to walk there. Walk up to someone to start talking. You join muted, so click the microphone button or press M when you want to speak.

6. Invite more people later

To invite people after you're in the office, click "Invite members" at the bottom of the sidebar. You can also open the gear menu at the top of the sidebar and choose "Invite members".

The admin menu opened from the gear icon at the top of the sidebar, with Invite members, Manage members, and Manage billing.
The gear menu. Besides invitations, this is where you remove members and manage billing.

In the "Invite members" panel, first pick a role under "Role for the person you invite": Member or Admin. Admins can invite others and manage members too. Then choose how to reach them under "How do you want to reach them?":

  • Send by email: enter addresses and click "Send email invites". Hiroba emails each person a link to join.
  • Share a link: click "Copy a new invite link". The link is created and copied in one go, so you can paste it to your teammate in Slack or another chat.
The Invite members panel: a Member/Admin toggle under Role for the person you invite, two cards under How do you want to reach them? (Send by email and Share a link), an email field with a Send email invites button, and a Pending invites list with one emailed invite and one invite link, each with a Revoke button.
The "Invite members" panel. Pick a role and a delivery method, then send.
The Invite members panel right after creating a link with Share a link: under the message Link copied. Paste it to your teammate. are the invite link with a Copy button and a Make a link for one more person button, and the new link is highlighted at the end of the Pending invites list.
Right after "Share a link" created a link. The same link works for everyone you send it to.

Invites expire 7 days after they're created. Unused invites are listed under "Pending invites". A link invite can be copied again with "Copy", and any invite you sent by mistake can be cancelled with "Revoke".

7. How invited teammates join

This part is for the person who received the invite. (If an invite email doesn't show up, check the spam folder.) Opening the link from the email or chat shows this page:

The page shown when opening an invite link. Under the heading You're invited to Acme Inc and the line Invited by Aoi there are Sign in with Google and Sign in with GitHub buttons, an email field with an Email me a code button, and further down, under Try it without an account, an Enter as a guest button.
The invite page. Sign in to become a member, or enter as a guest from the browser.

There are two ways to join.

Enter as a guest from the browser (nothing to install)

Click "Enter as a guest" and Hiroba opens in your browser. Pick a display name and color, click "Enter Hiroba", and you're in. No sign-in needed. When you just want someone to try it, this is the easiest way.

The browser join screen with the message You're joining as a guest from an invite link. Enter a name and you're in. Below it are a display name field filled in with Ren, color choices, and an Enter Hiroba button.
To enter as a guest, just choose a name and color.

Once you're in, you're on the same floor as the person who invited you, and they show up in your sidebar with a "Call" button next to their name.

Join from the desktop app

For everyday use, we recommend the desktop app. On the invite page, sign in with Google, GitHub, or your email address. Your account is created as you sign in, and you become a member of the organization right there.

The page after signing in. Under the heading You've joined Acme Inc and the line Signed in with Google as ren@example.com there is an Open in Hiroba button, and below it, under Don't have the app yet?, a Download for Mac button.
Once you've signed in, you're a member. All that's left is to open the app.

If the app is already installed, click "Open in Hiroba" and it opens straight into the office. If not, install it with the download button under "Don't have the app yet?" (it matches your operating system), open it, and sign in with the same account you used on the invite page. You're already a member, so there's no need to open the invite link again.

Once they've joined

Your teammate appears in your office right away. Walk up to them to talk, or use "Call" in the sidebar to reach someone in another part of the office.

The inviter's Hiroba app. The sidebar lists Aoi (you) and Ren with a Call button next to Ren. Both avatars stand together in the middle of the floor, with the hint Someone's nearby — press M to talk.
Two people on the same floor. When someone is nearby, Hiroba reminds you to press M to talk.

That's it. Start with two or three people, pick a time, and spend it in the office together.

Creating an organization starts a 30-day free trial automatically. No card required, and no limits on people or features. After the trial, it's $2 per seat per month.

Download Hiroba→

FAQ

Do invited teammates need to create an account?

Not to enter as a guest: they open the invite link, enter a name, and they're in. To join as a member, they sign in on the invite page with Google, GitHub, or an email address, and the account is created as they do.

How long are invite links valid?

Seven days from when they're created. If one expires, ask an admin for a new one. Admins can also revoke unused invites from the "Invite members" panel.

What happens after the free trial?

After the 30-day trial, the hosted edition costs $2 per seat per month. When the trial ends, admins see a button to start a subscription, and payment details are entered on Stripe's checkout page.

How do I get back in next time?

The app remembers that you're signed in, so next time you open it and click "Enter Hiroba".

Can I belong to more than one organization?

Yes. While signed in, open the organization menu on the sign-in screen to switch between your organizations or choose "+ New organization".

Give your team a floor to stand on.

Self-host the open-source server, or try the hosted edition: 30 days free, no card required.