# 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](https://docs.luxonis.com/software-v3/oak-apps.md) and has already been
packaged into a .oakapp file.

If you still need to build the app artifact, use the [oakctl guide](https://docs.luxonis.com/software-v3/oak-apps/oakctl.md)
first.

## Publish the app

### Authenticate oakctl

Authenticate oakctl with your Luxonis Hub workspace.

```bash
oakctl hub login
```

### Publish the built .oakapp file

Publish the built application artifact.

```bash
oakctl 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](https://hub.luxonis.com/control/apps/team-apps) to confirm that the upload finished
successfully and that the app is available in your workspace.

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. |

## Related docs

### OAK Apps

Learn how OAK Apps are structured and packaged.

[OAK Apps](https://docs.luxonis.com/software-v3/oak-apps.md)

### oakctl

Build and publish application artifacts with the Luxonis CLI.

[oakctl](https://docs.luxonis.com/software-v3/oak-apps/oakctl.md)

### Manage Applications

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

[Manage Applications](https://docs.luxonis.com/cloud/features/application-management/manage-applications.md)

### App Store

See how published applications appear inside Luxonis Hub.

[App Store](https://docs.luxonis.com/cloud/features/application-management/app-store.md)