# hub app <name>

Source: https://docs.myhub.host/cli/app

Check, share and run one app. \<name> is the app, or `app/instance` for an instance other than prod, such as `my-app/staging`.

## Usage

```sh
hub app <name> <command> [options]
```

## Examples

```sh
# Open the app in your browser
hub app my-app open

# Check its status
hub app my-app status

# Follow build and runtime logs
hub app my-app logs

# Owner and invited people only
hub app my-app access private

# Let someone use this app
hub app my-app invite client@example.com

# The staging instance of my-app
hub app my-app/staging status
```

## Check

| Command                                      | Description                                                                  |
| -------------------------------------------- | ---------------------------------------------------------------------------- |
| [`hub app <name> open`](https://docs.myhub.host/cli/app/open)       | Open the app in your browser.                                                |
| [`hub app <name> status`](https://docs.myhub.host/cli/app/status)   | Show its URL, access, release and services.                                  |
| [`hub app <name> logs`](https://docs.myhub.host/cli/app/logs)       | Show build and runtime logs.                                                 |
| [`hub app <name> runtime`](https://docs.myhub.host/cli/app/runtime) | Inspect runtime or change sleep settings for every service in this instance. |

## Share

| Command                                        | Description                                                                   |
| ---------------------------------------------- | ----------------------------------------------------------------------------- |
| [`hub app <name> access`](https://docs.myhub.host/cli/app/access)     | Show or choose who can open the app.                                          |
| [`hub app <name> invite`](https://docs.myhub.host/cli/app/invite)     | Let someone use this app without joining your org.                            |
| [`hub app <name> invites`](https://docs.myhub.host/cli/app/invites)   | List the people invited to this app.                                          |
| [`hub app <name> uninvite`](https://docs.myhub.host/cli/app/uninvite) | Take back an invitation to this app. The person is out on their next request. |

## Configure and release

| Command                                        | Description                                                                            |
| ---------------------------------------------- | -------------------------------------------------------------------------------------- |
| [`hub app <name> env`](https://docs.myhub.host/cli/app/env)           | List the environment variable names of the app.                                        |
| [`hub app <name> git`](https://docs.myhub.host/cli/app/git)           | Show or change the GitHub source the app deploys from.                                 |
| [`hub app <name> instance`](https://docs.myhub.host/cli/app/instance) | Manage the instances of the app.                                                       |
| [`hub app <name> releases`](https://docs.myhub.host/cli/app/releases) | List the releases.                                                                     |
| [`hub app <name> rollback`](https://docs.myhub.host/cli/app/rollback) | Go back to an earlier release.                                                         |
| [`hub app <name> redeploy`](https://docs.myhub.host/cli/app/redeploy) | Deploy the branch head again (from GitHub), or rebuild the current release (uploaded). |

## Operate

| Command                                      | Description                                                               |
| -------------------------------------------- | ------------------------------------------------------------------------- |
| [`hub app <name> restart`](https://docs.myhub.host/cli/app/restart) | Restart the app and wait for completion.                                  |
| [`hub app <name> stop`](https://docs.myhub.host/cli/app/stop)       | Stop the app and wait for completion.                                     |
| [`hub app <name> start`](https://docs.myhub.host/cli/app/start)     | Start the app after a stop and wait for completion.                       |
| [`hub app <name> suspend`](https://docs.myhub.host/cli/app/suspend) | Suspend every service to RAM and wait; requests can wake it.              |
| [`hub app <name> exec`](https://docs.myhub.host/cli/app/exec)       | Run a command inside the app.                                             |
| [`hub app <name> shell`](https://docs.myhub.host/cli/app/shell)     | Open a shell inside the app.                                              |
| [`hub app <name> rm`](https://docs.myhub.host/cli/app/rm)           | Delete the app with every instance, or one instance given `app/instance`. |