Goki and Portal

Locks are installed using the Portal Staff App and linked to doors in Portal. This article explains how to log in, create a door, select the correct device type, and complete lock installation using Bluetooth.

___________________________________________________________

You have access to the Portal Staff App

You use the same login credentials as the Portal Dashboard

- You have access to the Portal Staff App
- You use the same login credentials as the Portal Dashboard
- You have permission to install locks
- The lock has battery power and is nearby

Portal Staff App: Mobile app used for lock installation and on-site actions.

Door: A digital representation of a physical access point.

Device Type: The hardware model selected during installation.

Bluetooth (BLE): Used to detect and install locks.

- Portal Staff App: Mobile app used for lock installation and on-site actions.
- Door: A digital representation of a physical access point.
- Device Type: The hardware model selected during installation.
- Bluetooth (BLE): Used to detect and install locks.

Staff must use their Portal Dashboard credentials.

Log in using your Portal Dashboard email and password.

Confirm you have permission to install locks.

1. Open the Portal Staff App.
2. Log in using your Portal Dashboard email and password.
3. Confirm you have permission to install locks.

1. Open the Doors tab.
2. Tap the + (Add) button.
3. Select a Door Type.
4. Enter a Door Name.
5. Tap Add.

After creating the door, choose the correct hardware model.

Choose the hardware model that matches the lock.

1. Select the Device Type.
2. Choose the hardware model that matches the lock.

This ensures correct communication between the app and the lock.

Complete the installation by connecting to the lock.

Allow the app to search for nearby locks.

1. Stay within Bluetooth range of the lock.
2. Allow the app to search for nearby locks.
3. Select the lock when it appears.
4. Follow the on-screen instructions.
5. Complete the installation.

Once finished, the lock is linked to the door automatically.

Lock details appear in the Portal Dashboard

The Locks and Settings tabs become available for the door

Firmware, connectivity, and lock status are visible

- Lock details appear in the Portal Dashboard
- The Locks and Settings tabs become available for the door
- Firmware, connectivity, and lock status are visible

- Install locks close to the device
- Verify battery power before installation
- Select the correct device type
- Complete installation in one session

The lock does not appear during installation Check battery power and stay within Bluetooth range.

Installation fails midway Move closer to the lock and restart the process.

I can’t install locks Verify your role includes installation permissions.

<a href="https://support.tryportal.com/en/articles/13311422-portal-how-to-manage-doors">Manage Doors in Portal</a>

<a href="https://support.tryportal.com/en/articles/13311422-portal-how-to-manage-doors">Lock Settings and Passage Mode</a>

<a href="https://intercom.help/portal-c0de953b4f4a/en/articles/12680169-portal-manage-your-team-members-permissions" target="_blank" rel="nofollow noopener noreferrer">Portal Roles and Permissions</a>

- <a href="https://support.tryportal.com/en/articles/13311422-portal-how-to-manage-doors">Manage Doors in Portal</a>
- <a href="https://support.tryportal.com/en/articles/13311422-portal-how-to-manage-doors">Lock Settings and Passage Mode</a>
- <a href="https://intercom.help/portal-c0de953b4f4a/en/articles/12680169-portal-manage-your-team-members-permissions" target="_blank" rel="nofollow noopener noreferrer">Portal Roles and Permissions</a>
 Demo:

ScreenRecording_12-10-2025 10-22-37_1 (1).mov

This article explains how staff can install a lock on a door using the Portal Staff App. Staff must have the correct permissions to complete this process.

Portal-How to Add Device via Portal app

Find answers and get help from Intercom Support and Community Experts

This site employs cookies and other technologies that we and our third party vendors use to monitor and record personal information about you and your interactions with the site (including content viewed, cursor movements, screen recordings, and chat contents) for the purposes described in our Cookie Policy. By continuing to visit our site, you agree to our {websiteTermsLink}, {privacyPolicyLink} and {cookiePolicyLink}.

This site uses cookies and similar technologies ("cookies") as strictly necessary for site operation. We and our partners also would like to set additional cookies to enable site performance analytics, functionality, advertising and social media features. See our {cookiePolicyLink} for details. You can change your cookie preferences in our Cookie Settings.

We use cookies to make our site work and also for analytics and advertising purposes. You can enable or disable optional cookies as desired. See our {cookiePolicyLink} for more details.

Advertising cookies are set by our advertising partners to collect information about your use of the site, our communications, and other online services over time and with different browsers and devices. They use this information to show you ads online that they think will interest you and measure the ads' performance. Social media cookies are set by social media platforms to enable you to share content on those platforms, and are capable of tracking information about your activity across other online services for use as described in their privacy policies.

These cookies enable the website to provide enhanced functionality and personalisation. They may be set by us or by third party providers whose services we have added to our pages. If you do not allow these cookies then some or all of these services may not function properly.

These cookies are necessary for the website to function and cannot be switched off in our systems.

These cookies allow us to count visits and traffic sources so we can measure and improve the performance of our site. They help us to know which pages are the most and least popular and see how visitors move around the site.

You have the right to opt out of the sale of your personal information. See our {cookiePolicyLink} for more details about how we use your data.

Your Privacy Choices

We use cookies to enhance your experience. You can customize your cookie preferences below. See our {cookiePolicyLink} for more details.

Cookie Settings

Link, Press control-option-right-arrow to exit

Empty Help Center

Uh oh. That page doesn’t exist.

Disappointed

Neutral

Smiley

Thinking...

Searching through sources...

Analyzing...

Tickets submitted through the messenger or by a support agent in your conversation will appear here.

Role	Lock Installation Access
Owner	Full access
General Manager	Full access
Installer	Install and remove locks
Team	No installation access
Housekeeping	No installation access

Portal-How to Add Device via Portal app

Overview

Before You Start

Key Concepts

How to Install a Lock

Log In to the Portal Staff App

Create a Door in the Portal Staff App

Select the Device Type

Install the Lock via Bluetooth

After Installation

Permissions & Access

Tips / Best Practices

Troubleshooting / FAQs

Related Articles