The BRCK Local/ Offline Dashboard
To access the Local Dashboard:
- Turn on your BRCK. If it is blinking red, connect it to a power source and let it charge to prevent it from going off unexpectedly. Connect to the WiFi signal the BRCK broadcasts. It looks something like BRCK_XXXXXXXXXXXX.
- Open your preferred browser on your computer/ smartphone or tablet once you connect and type 192.168.69.1 or local.brck.com into the address bar and hit Enter. You should see a screen like this one below appear:
Parts of the Local Dashboard
This is a cable connection to the BRCK using the ethernet port physically located on the BRCK. By default, if you connect an internet-enabled cable to the BRCK, it should automatically pick up the settings from your router (the device at the other end of the cable that is the source of the internet.)
To configure an ethernet connection, click on Configure on the Ethernet tab. You’ll see a screen like the one below. The default configuration is DHCP, which means that the BRCK automatically picks up the connection settings from the router. If you do not know what your settings are, it is best to leave it this way.
However, if you would like alternative settings or if you know your internet ethernet settings, click on the Protocol drop-down menu and select Static.
From here, you can input your settings and click on Save.
A WiFi bridge allows you to connect to the internet through an existing WiFi connection. If you click on Configure on the WiFi Bridge tab, you should see the BRCK looking for existing WiFi networks.
Once Wi-Fi networks are detected, the BRCK will show you a list of them and from here you can select the one you’d like to connect to. If you select a password-protected network, the BRCK prompts you for the password as shown below:
When you enter the password and click on Save, the BRCK checks whether the password is correct then connects you. If not, you will get an error message asking you to re-type the password.
The third option on the local dash is the SIM. To use this, you have to have a data-enabled SIM card with internet bundles or airtime credit to access the Internet. When you click on Configure on this tab, you will see a screen similar to this:
The BRCK comes with SIM settings for over 180 mobile phone service providers. It will pick up the settings automatically. The screenshot above shows a BRCK without a SIM. If a SIM is inserted and it has a PIN, the BRCK will display information as follows:
If you choose to, you can put in the settings manually and click on Save and the BRCK will update the settings accordingly.
The BRCKNet option is BRCK’s vMNO or MVNO (virtual mobile network operator and mobile virtual network operator) service. This means BRCK does not own the network infrastructure but can provide the same services as a mobile phone service provider and you will not have to get a SIM card or some other communication equipment from a given carrier.
We have not rolled out this service yet but if you click on Configure on the tab below it, you should see the page below:
You can also send text messages from your BRCK using the installed text message utility. You will need a SIM card with airtime credit to do this.
Troubleshooting the Local Dashboard
Sometimes you may not be able to access the local dashboard. Your browser may ‘remember’ previous settings and prevent you from accessing the dash. This is called caching. The solution for this depends on your browser.
For Google Chrome;
- Go to Settings by clicking on the top right corner button, then scrolling to Settings. This is the button with the 3 horizontal lines (hamburger menu icon).
- Scroll down and click on Show Advanced Settings.
- Under the Privacy tab, click on Clear browsing data.
- For BRCK troubleshooting, you only need to select Cookies and other site and plugin data and Cached images and files. The data you’d like to clear depends on how long you’ve had your BRCK. If you’ve had it for more than a month, from the beginning of time is the option you should go for. Click on Clear browsing data once you’ve made your selections.
- Close your browser and re-open it and enter local.brck.com or 192.168.69.1. All your settings on the BRCK will remain intact.
For Mozilla Firefox
- On the top-right corner of the browser window, click on Open menu (hamburger menu icon on the top-right corner).
- Click on Preferences and go to Advanced. From here, click on Clear now under the Cached Web Content tab.
Depending on your Firefox version, the layout may be slightly different but all the steps remain the same. From here, you can now try accessing the local dash again. You can also force a page refresh by typing Ctrl+Shift+R.
Opening a page in Incognito mode (Chrome) or Private Mode (Firefox) also mitigates against browser caching:
- For Google Chrome, open Google Chrome and type Shift+Ctrl+N to open a private window.
- For Firefox, hit the Alt button to show the File menu. Scroll to Open New Private Window.
- For Windows, the keyboard shortcut is Ctrl+N. For Linux, it is Shift+Ctrl+P.
Common Error Messages
‘Unable to launch the requested CGI Program’ and ‘The CGI Process did not produce any response.’
CGI - common gateway interface - is a way to generate the content you are viewing on the local dash. This error occurs when the custom program scripts on the BRCK have not launched. Restarting the BRCK and reconnecting to it fixes this. The errors are shown below:
‘Access to this resource is forbidden’.
This is seen when the BRCK performs an update and then goes offline before the update is complete. To sort this out, you will need a working internet connection.
Turn on your BRCK and give it a few minutes to initialize. Since you had previously configured a connection, the BRCK should turn a solid blue on the outside (3G), a solid green (WiFi bridge) or a solid purple (ethernet). Give the BRCK about ten minutes to complete updates and then restart it (switch it off then on).
Try accessing the local dash again after this. If the issue persists, the BRCK may require more skilled troubleshooting. Get in touch with our support team at firstname.lastname@example.org and we’d be glad to help.