Get Started with BuildBee - BuildBee Support

Get Started with BuildBee


Congratulations! You’re the proud new owner of our latest and greatest CloudDock! With this awesome piece of technology, you can control your 3D printer over the Internet. BuildBee is comprised of two products. Firstly, a physical control box called the CloudDock which acts as the brains for the 3D printer, allowing it to shake hands with the cloud. The second product is a web app which allows you to run, maintain and manage access to your 3D printers.

Enterprise subscriptions: You might need an IT staff member to help you if your school/organisation has an unusual network environment.

Here’s how to get started:


Before you start

Compatibility 
To use buildbee.com, you will need to use a compatible operating system and browser. Here is a list of our supported operating systems and browsers:

Operating systems:
  1. Windows 8.1 or above
  2. MacOS Mountain Lion or later

Browsers:
  1. Microsoft Edge version 15 or above (not Internet Explorer)
  2. Google Chrome version 45 or above
  3. Safari version 10 or above
  4. Firefox version 55 or above
You will also need to know your network details, including the network name, password and whether your wireless connection uses 2.4GHz or 5.0 GHz. If using a wireless connection, consider the strength of the WiFi signal in the room you plan on putting your printer/s.
You can also test the compatibility of your network environment to make sure all cloud resources are accessible. If any of the tests fail, please refer to our IT: Domains for whitelisting help article.

Create an account

To use BuildBee, you must first create an account. This is a quick and easy process!
Any account created this way is a Free tier account.

Method 1 - Create an account using your email address

- Navigate to https://app.buildbee.com/.

Select 'CREATE ACCOUNT'.

BuildBee create account


Enter a valid email address and create a password in the provided spaces. 
Your password must be at least 8 characters and include at least one capital letter and one number. 
- Click 'CREATE ACCOUNT' to finish. A verification link will be sent to your email, this may take a few minutes.

BuildBee create account

- When you receive the email, click the verification link to confirm your account. You can now navigate back to https://app.buildbee.com/ and sign in using your new account details.


Method 2 - Create an account using 'SIGN IN WITH GOOGLE' button

- Select the 'SIGN IN WITH GOOGLE' button.
- This will automatically create an account for you with your Gmail or Google enterprise email (this includes DET addresses). You will be automatically logged after confirming your details.

BuildBee sign in with Google


From here, you can start configuring printers to use with your account or be added to a site that has printers associated with it. Make sure you then get the correct rights applied to your account.


Configuring a BuildBee CloudDock

To connect your printer to the BuildBee app you must first configure your BuildBee CloudDock to access the Internet. You can also use this process when changing networks or connection type (WiFi or Ethernet). This process takes around 5 minutes to complete and you will need a valid BuildBee account, your network details and a FAT32 USB drive.

For a more information on the configuration process, please refer to the BuildBee configuration help article.

Step 1 - Log in to BuildBee

- Navigate to https://app.buildbee.com

- Sign in using an account that has the right to configure printers.

Step 2 - Create the configuration file

- Select the printer list icon in the top right corner of the screen. 

BuildBee printer list

- Select 'CONFIGURE PRINTER' from the top of the printer list:


BuildBee configure button


- Choose the option that is best suited to you network: 
BuildBee configure printer

- Fill in your network details in the spaces provided and select the 'GENERATE CONFIG. FILE' button.  
WiFi network names and passwords are case sensitive. Any errors will cause the configuration process to fail.


BuildBee DET ET4LBuildBee personal WiFi


Step 3 - Save the BuildBee configuration file to a USB drive

- Select the 'Download' button to save the .conf  file to your computer.


BuildBee download config


- Move the configuration file to the root folder of a USB flash drive (not within any other folders). 


We recommend using a USB drive from a known manufacturer (e.g. Toshiba), formatted to FAT32, without any partitions. Promotional USB drives are not reliable for this process.


Move config to USB


Step 4 - Load configuration file onto a CloudDock

- Remove ALL cables from the BuildBee CloudDock (no power, no USB cable).




- Insert the USB drive into the BuildBee CloudDock.



- Plug the power supply into the BuildBee CloudDock with the USB drive inserted. 

Do not connect the printer yet.




- The CloudDock will read the configuration file and erase it from the USB drive, replacing it with a 'configuration receipt' (send us this receipt if something goes wrong):

Configuration receipt

- If the CloudDock can successfully reach the internet, it will appear in your printer list. 
It may take up to 4 minutes to complete the registration and you may need to refresh your browser for it to appear.

- The CloudDock that represents the printer will first appear as 'DISCONNECTED', simply meaning there is no printer connected. At this point you may safely remove the USB drive. 




- Connect your CloudDock to your 3D printer via USB cable. The CloudDock will then appear as 'READY' in the printer list.


If you're having trouble with configuration, please run through the troubleshooting guide in the A printer is showing up as 'Offline' help article.  

 

Adding users to your site (Enterprise)

To allow users to access the same printers, they will have to be added to your BuildBee site.

To add other users to a site, you must have an account with the right to manage groups, users and printers within that site.

Site managers

Step 1 - Access enterprise tools

Log in to an account with the right to manage groups, users and printers.
- Select the enterprise tools icon from the top right corner of the BuildBee interface.

BuildBee enterprise tools


Step 2 - Generate a join code

- Access the 'users' section:


BuildBee user section

- Select 'OPEN' to generate a random set of words which will be the code for other users to join your site.

BuildBee add users to site

BuildBee random code


Each code can only be used while the site is open and is no longer valid once you select 'CLOSE'.

Users joining a site

Step 1 - Open the 'Join School/Organization' page

- On a Free account, select the 'My Account' icon from the top right corner of the BuildBee interface.
- Select 'Join school/Organization' from the drop-down menu:

BuildBee join school organization


Step 2 - Enter the site registration code

-Type in the code that was generated and click 'JOIN'.

BuildBee enter code


 - Lastly, refresh your page to apply the changes.

If you aren't seeing any printers, check if your account is in a group that allows access to printers. If you have any further issues, please submit a support request.


Creating groups (Enterprise)

To use groups and permissions features, you must be on an enterprise level subscription.

The BuildBee group management tools allow you to apply different access permissions to individual user accounts within the same site.

These permissions include:

  1. Submit print jobs to a supervised queue
  2. Print unsupervised on any printer attached to this group
  3. Access the maintenance console of any printer attached to this group
  4. View the site overview dashboard within the enterprise tools
  5. Access the lesson plans for teachers
  6. Create, modify and delete groups; access all printers and control the queue

Step 1 - Access groups in enterprise tools

- Select the 'enterprise tools' button at the top of the page:

BuildBee enterprise tools

- Then, select the 'groups' button on the left side of the page:


BuildBee groups and permissions


Step 2 - Create a group

- Create a group by selecting the large 'plus' button.


- Give the group a name.

Step 3 - Add users and printers to the group

- Access the group you just created.

- Select the pencil 'edit' button located just under the name of the group:

BuildBee edit group


Add users

- Select the 'USERS' tab.
- To add users to the group,  select the large 'plus' icon:

BuildBee add users

- Select users from the left column labelled 'Unselected' to grant access to them. If you make a mistake, you can select them on the right hand column to remove them from your selection.

BuildBee add user to group

- Select the 'ADD SELECTED TO GROUP' button to confirm your selection and return to the group page.

Add printers

- Select the 'PRINTERS' tab.
- To add printers to the group,  select the large 'plus' icon:

BuildBee add users

- Select printers from the left column labelled 'Unselected' to grant access to them. If you make a mistake, you can select them on the right hand column to remove them from your selection.


- Select the 'ADD SELECTED TO GROUP' button to confirm your selection and return to the group page.

Step 4 - Assign group rights

- Whilst still editing the group you created, select the switches next to each permission you wish to assign to that group. 
Rights are additive. This means that if an account has gained the right to perform an action, it will retain that right even if another group removes that right. The account must be removed from any groups with contradicting rights. We recommend reading our help article on recommended group structures to get some tips on how to set up your groups to achieve the level of access you wish to provide.



- Turning the group activity switch off will disable all the rights you have selected for that group. Turning it back on will apply the same rights you had previously chosen.


Step 5 - Save your changes

- Once you're happy with the changes you've made, scroll back to the top of the screen and select 'SAVE'.
If you don't select 'SAVE', any changes to users and/or printers you made will be lost.

BuildBee save group


Enabling the print queue (Enterprise)

To enable queuing for your site, you simply have to turn on the correct right for your users. You have the option of having a site-wide queue or a queue for specific groups.

Once the right to print to a queue is enabled, users will see the option to add to a queue in the printer selection step in the print process.

Site-wide queuing

Step 1 - Access enterprise tools

Log in to an account that is capable of making changes to a sites global rights.
- Select the 'enterprise tools' icon from the top right hand corner of the screen. 



Step 2 - Update global rights

- Select the 'groups' section from the side menu:


- Select the 'CHANGE GLOBAL RIGHTS' button from the bottom of the page. Here you will also be able to see what global rights are currently turned on:


Select the switch next to 'All users can submit print jobs to a supervised queue'.
- Select the 'UPDATE GLOBAL RIGHTS' button to save your changes and apply them to all users within your site.
By default, no access permissions are granted to any users within the site.

enable_site_wide_queue.PNG


Group queuing 

Step 1 - Access enterprise tools

Log in to an account that is capable of making changes to a sites global rights.
- Select the 'enterprise tools' icon from the top right hand corner of the screen. 



Step 2 - Edit group rights

- Select the 'groups' section from the side menu:


- Select the group you would like to enable queuing for and click on the pencil 'edit' button located just under the name of the group. 



- Select the 'Submit print jobs to a supervised queue' switch. 
- Select the red 'SAVE' button to save the changes you have made to your group.

For information on how to use the queue, refer to the help articles listed below:

Using BuildBee is fairly intuitive but if you want to learn more about how it works or if you need to troubleshoot anything then check out our support articles for more info. Happy Printing!


    • Related Articles

    • Get started with the BuildBee plugin on OctoPrint

      Installing the BuildBee OctoPrint Plugin will give you access to a BuildBee web app features including a powerful cloud slicing engine, secure file management, easy remote access to your 3D printer(s) from any device, queuing (Pro) and presets for ...
    • IT: NSWDoE Schools Installation - central server connection

      This guide is for schools using the "detnsw" network and connecting to the central server.  Configuration for schools using the "Internet @ edge" method may connect differently. To connect your 3D printer to the BuildBee app, you must first configure ...
    • Introducing BuildBee Desktop

      What is BuildBee Desktop? BuildBee Desktop allows you to: Connect and host your 3D printer to make t available on yor BuildBee cloud without a CloudDock. Use BuildBee as a native stand-alone application on Windows and MAC without a web browser. ...
    • Getting started with BuildBee Desktop

      BuildBee Desktop can be used as a host for your 3D printer to make it available remotely, to setup and maintain BuildBee CloudDocks or to access other BuildBee apps. BuildBee Desktop - Installation - Go to the download page and click the download ...
    • Create or connect a BuildBee CloudDock

      You can now make your own BuildBee CloudDock with existing Raspberry Pi hardware using the built in wizards in BuildBee Desktop. Simply launch the wizard and follow the steps. Prep - Make sure you have all the required hardware - Raspberry Pi 3B or ...