Upload Custom Applications

Use this page when you already have a built .oakapp file and want to publish it to Luxonis Hub for your workspace.

Before you upload

Make sure the application follows the OAK App structure and has already been packaged into a .oakapp file.If you still need to build the app artifact, use the oakctl guide first.

Publish the app

Authenticate `oakctl`

Authenticate oakctl with your Luxonis Hub workspace.

Command Line

1oakctl hub login

Publish the built `.oakapp` file

Publish the built application artifact.

Command Line

1oakctl hub publish <oakapp-file>

Wait for validation

Wait for the upload and validation to finish in Luxonis Hub.

Private by default

Uploaded applications are visible only to your organization unless you explicitly publish them through a broader distribution path.

Verify the result

After publishing, open the Team Apps page to confirm that the upload finished successfully and that the app is available in your workspace.

Team Apps page in Luxonis Hub showing uploaded applications — Team Apps in Luxonis Hub showing uploaded applications and their current upload status.

Use these statuses to understand whether the upload is ready to use or needs attention.

Status	Meaning
`Completed`	The application uploaded successfully and is now available in your workspace.
`Rejected`	The upload failed validation, such as missing metadata, invalid structure, or unsupported format.
`Failed`	The upload did not finish because of a server-side or network error.

OAK Apps

Learn how OAK Apps are structured and packaged.

oakctl

Build and publish application artifacts with the Luxonis CLI.

Manage Applications

Install, start, stop, and inspect apps after they are published.

App Store

See how published applications appear inside Luxonis Hub.

ON THIS PAGE