ON THIS PAGE

  • Uploading Custom Applications
  • Prepare and Build Your Application
  • Authenticate `oakctl` with Hub
  • Upload the Application
  • Verify Upload Status

Uploading Custom Applications

You can upload your own OAK Apps to Luxonis Hub to manage, deploy, and share them with your team.
1

Prepare and Build Your Application

Before uploading, make sure your application follows the OAK App structure and includes all required metadata and layers. You can then build the application locally using the oakctl command-line tool.

Build an application

Click here to learn more about `oakctl` and how to build an application.

2

Authenticate `oakctl` with Hub

Log in to your Hub account from the CLI:
Command Line
1oakctl hub login
This will authenticate your local environment with your Luxonis Hub workspace.
3

Upload the Application

Once authenticated, you can upload your built app file (.oakapp) to the Hub:
Command Line
1oakctl hub publish <oakapp-file>
This uploads the app to your team's workspace on Hub.
4

Verify Upload Status

After uploading, visit the Team Apps page to monitor the upload and build status.Each upload can result in one of the following states:
  • Completed: The application was successfully uploaded and is now available in your workspace.
  • Rejected: The upload failed validation (e.g., missing metadata, invalid structure, or unsupported format).
  • Failed: A server or network error occurred during upload. Try again or check the logs for details.