> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kombify.io/llms.txt
> Use this file to discover all available pages before exploring further.

# stackkit user

> Invita y gestiona a los usuarios del hogar en PocketID local

Invita y gestiona a los usuarios del hogar en PocketID local.

Crea, lista y elimina usuarios del Homelab en el grupo household de PocketID.

Add imprime una URL de configuración de passkey de un solo uso. TinyAuth sigue admitiendo a los grupos owners, admins y household ya vinculados en el cliente OIDC. Aquí no se pueden crear ni eliminar identidades de propietario y administrador.

```bash theme={null}
stackkit user [flags]
```

| Flag | Tipo | Predeterminado | Descripción |
| - | - | - | - |
| `--json` | bool | — | Emite JSON stackkit.command-result/v1 |

**Ejemplos**

```bash theme={null}
# Invite a household member; share the printed one-time URL only with them
stackkit user add alex --email alex@example.com --owner-approve

# List household users
stackkit user list

# Remove a household user
stackkit user remove alex --owner-approve
```

Subcomandos: [`stackkit user activate`](#stackkit-user-activate), [`stackkit user add`](#stackkit-user-add), [`stackkit user files`](#stackkit-user-files), [`stackkit user list`](#stackkit-user-list), [`stackkit user owner`](#stackkit-user-owner), [`stackkit user remove`](#stackkit-user-remove)

## stackkit user activate

Vuelve a emitir la inscripción de passkey para un miembro existente del hogar.

```bash theme={null}
stackkit user activate <username> [flags]
```

| Flag | Tipo | Predeterminado | Descripción |
| - | - | - | - |
| `--owner-approve` | bool | — | Aprueba explícitamente volver a emitir la inscripción de passkey del hogar |

Heredado de `stackkit user`:

| Flag | Tipo | Predeterminado | Descripción |
| - | - | - | - |
| `--json` | bool | — | Emite JSON stackkit.command-result/v1 |

## stackkit user add

Invita a un usuario del hogar con una URL de configuración de passkey de un solo uso.

```bash theme={null}
stackkit user add <username> [flags]
```

| Flag | Tipo | Predeterminado | Descripción |
| - | - | - | - |
| `--display-name` | string | — | Nombre visible opcional |
| `--email` | string | — | **Obligatorio.** Correo del miembro del hogar |
| `--owner-approve` | bool | — | Aprueba explícitamente la creación de este usuario del hogar |

Heredado de `stackkit user`:

| Flag | Tipo | Predeterminado | Descripción |
| - | - | - | - |
| `--json` | bool | — | Emite JSON stackkit.command-result/v1 |

**Ejemplos**

```bash theme={null}
# Invite a household member and print their one-time passkey setup URL
stackkit user add alex --email alex@example.com --owner-approve

# Set a display name and return the invitation as JSON
stackkit user add sam --email sam@example.com --display-name "Sam Doe" --owner-approve --json
```

## stackkit user files

Reanuda y entrega las cuentas locales de Files para el hogar.

Cloudreve CE mantiene una cuenta local de la aplicación detrás de TinyAuth. Estos comandos hacen converger esa cuenta desde una identidad aprobada del hogar de PocketID y solo revelan su contraseña bajo custodia del propietario cuando se solicita explícitamente.

```bash theme={null}
stackkit user files [flags]
```

Heredado de `stackkit user`:

| Flag | Tipo | Predeterminado | Descripción |
| - | - | - | - |
| `--json` | bool | — | Emite JSON stackkit.command-result/v1 |

Subcomandos: [`stackkit user files credential`](#stackkit-user-files-credential), [`stackkit user files ensure`](#stackkit-user-files-ensure)

### stackkit user files credential

Muestra una contraseña de Files del hogar bajo custodia del propietario.

Verifica la identidad aprobada del hogar de PocketID y su cuenta de Cloudreve sin privilegios administrativos, y después muestra la contraseña existente desde la custodia firmada del propietario local. La salida contiene material secreto; úsala solo en un terminal privado o en una canalización intencionada.

```bash theme={null}
stackkit user files credential <username> [flags]
```

| Flag | Tipo | Predeterminado | Descripción |
| - | - | - | - |
| `--owner-approve` | bool | — | Aprueba explícitamente revelar esta contraseña de Files |

Heredado de `stackkit user`:

| Flag | Tipo | Predeterminado | Descripción |
| - | - | - | - |
| `--json` | bool | — | Emite JSON stackkit.command-result/v1 |

### stackkit user files ensure

Crea o verifica una cuenta de Files sin privilegios administrativos.

```bash theme={null}
stackkit user files ensure <username> [flags]
```

| Flag | Tipo | Predeterminado | Descripción |
| - | - | - | - |
| `--owner-approve` | bool | — | Aprueba explícitamente el aprovisionamiento de la cuenta de Files |

Heredado de `stackkit user`:

| Flag | Tipo | Predeterminado | Descripción |
| - | - | - | - |
| `--json` | bool | — | Emite JSON stackkit.command-result/v1 |

## stackkit user list

Lista los usuarios del hogar en PocketID local.

```bash theme={null}
stackkit user list [flags]
```

Heredado de `stackkit user`:

| Flag | Tipo | Predeterminado | Descripción |
| - | - | - | - |
| `--json` | bool | — | Emite JSON stackkit.command-result/v1 |

**Ejemplos**

```bash theme={null}
# List household users
stackkit user list

# The same list as JSON
stackkit user list --json
```

## stackkit user owner

Inspecciona y reanuda la activación de la passkey del propietario de PocketID.

```bash theme={null}
stackkit user owner [flags]
```

Heredado de `stackkit user`:

| Flag | Tipo | Predeterminado | Descripción |
| - | - | - | - |
| `--json` | bool | — | Emite JSON stackkit.command-result/v1 |

Subcomandos: [`stackkit user owner activate`](#stackkit-user-owner-activate), [`stackkit user owner migrate-domain`](#stackkit-user-owner-migrate-domain), [`stackkit user owner status`](#stackkit-user-owner-status)

### stackkit user owner activate

Vuelve a emitir el enlace de activación de passkey de un solo uso ligado al propietario y retira el anterior.

```bash theme={null}
stackkit user owner activate [flags]
```

| Flag | Tipo | Predeterminado | Descripción |
| - | - | - | - |
| `--owner-approve` | bool | — | Aprueba explícitamente volver a emitir el enlace de activación del propietario |

Heredado de `stackkit user`:

| Flag | Tipo | Predeterminado | Descripción |
| - | - | - | - |
| `--json` | bool | — | Emite JSON stackkit.command-result/v1 |

### stackkit user owner migrate-domain

Prepara la migración de identidad de home a lab.home aprobada por el propietario.

Conserva el propietario, la CA, los secretos de servicio y los usuarios existentes mientras migra la intención de Basement y la custodia del entorno de ejecución de home a lab.home. Conserva la CLI de la versión anterior, las herramientas empaquetadas y el mirror de proveedores antes de usar una CLI de destino aislada para este comando. `--quiesce-runtime` autoriza al comando a capturar las identidades exactas de los contenedores Core de origen, hacer converger el callback de identidad mientras PocketID está disponible y después detener de forma ordenada y eliminar únicamente esos contenedores, sin borrar volúmenes, redes ni imágenes. Usa la CLI anterior para generate, apply y verify; después usa la CLI de destino para upgrade `--to` \<exact-release>. El punto de control de la actualización cubre la versión anterior migrada en lab.home; este comando no crea un punto de control de reversión al dominio original. El puente v0.47.4 está pendiente de validación en un host real. Después del despliegue, inscribe el DNS de cliente y nuevas passkeys en id.lab.home.

```bash theme={null}
stackkit user owner migrate-domain [flags]
```

| Flag | Tipo | Predeterminado | Descripción |
| - | - | - | - |
| `--owner-approve` | bool | — | Aprueba explícitamente la migración del dominio y la inscripción de nuevas passkeys |
| `--quiesce-runtime` | bool | — | Detiene de forma ordenada y elimina los contenedores Core de origen autenticados sin borrar recursos persistentes |
| `--spec` | string | `stack-spec.yaml` | StackSpec relativa al workspace que se migrará |

Heredado de `stackkit user`:

| Flag | Tipo | Predeterminado | Descripción |
| - | - | - | - |
| `--json` | bool | — | Emite JSON stackkit.command-result/v1 |

### stackkit user owner status

Lee el estado de activación de la passkey del propietario.

```bash theme={null}
stackkit user owner status [flags]
```

Heredado de `stackkit user`:

| Flag | Tipo | Predeterminado | Descripción |
| - | - | - | - |
| `--json` | bool | — | Emite JSON stackkit.command-result/v1 |

## stackkit user remove

Elimina a un usuario del hogar de PocketID local.

```bash theme={null}
stackkit user remove <username> [flags]
```

| Flag | Tipo | Predeterminado | Descripción |
| - | - | - | - |
| `--owner-approve` | bool | — | Aprueba explícitamente la eliminación de este usuario del hogar |

Heredado de `stackkit user`:

| Flag | Tipo | Predeterminado | Descripción |
| - | - | - | - |
| `--json` | bool | — | Emite JSON stackkit.command-result/v1 |

**Ejemplos**

```bash theme={null}
# Remove a household user
stackkit user remove alex --owner-approve
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.