Cómo restablecer una contraseña de administrador de Nextcloud con OCC

Si ya no puedes iniciar sesión en Nextcloud con una cuenta de administrador, el occcomando del servidor puede restablecer la contraseña de esa cuenta sin usar la interfaz web. occNextcloud utiliza la interfaz de línea de comandos para la administración. El restablecimiento cambia la contraseña de la cuenta de Nextcloud; no cambia tu contraseña de Linux, la contraseña de la base de datos ni la contraseña del panel de control de alojamiento.

Este tutorial utiliza el Manual de Administración de Nextcloud 35, disponible el 6 de octubre de 2026. El comando básico es estable en varias versiones, pero las rutas de instalación, los comandos PHP, las cuentas de servicio y los flujos de trabajo de los contenedores varían. Utilice los valores de ejemplo solo después de verificar cómo está instalada su propia instancia.

Lo que necesitas antes de ejecutar el reinicio

  • Acceso a la línea de comandos del servidor o del contenedor que ejecuta la aplicación PHP de Nextcloud.
  • La ruta del sistema de archivos a la instalación de Nextcloud, que es el directorio que contiene el occarchivo.
  • El ID exacto de la cuenta de Nextcloud cuya contraseña debe cambiarse. El ID de la cuenta puede no ser admin.
  • La cuenta del sistema operativo que utiliza el servidor web o el entorno de ejecución de PHP. En Debian y Ubuntu suele ser www-data; otros sistemas pueden usar otra cuenta.
  • Una contraseña nueva y única almacenada en un gestor de contraseñas.

Ejecute occla aplicación como usuario HTTP (la cuenta del sistema operativo que ejecuta la aplicación web) para que la propiedad y los permisos de los archivos se mantengan constantes. El manual de Nextcloud documenta este requisito. No ejecute comandos como root por defecto solo porque tenga acceso sudo.

Paso 1: Encuentra la instalación y la cuenta correctas.

Conéctese mediante SSH o abra la consola proporcionada por su entorno de alojamiento. Navegue hasta el directorio de instalación de Nextcloud. Una ruta de instalación común es /var/www/nextcloud, pero los paquetes, dispositivos, contenedores y servicios alojados pueden usar rutas diferentes.

cd /var/www/nextcloud
ls -l occ

El segundo comando debería mostrar un occarchivo. Si no lo hace, deténgase y localice el directorio de la aplicación en lugar de intentar con rutas supuestas. Si tiene un nombre de cuenta diferente, reemplácelo adminen el comando posterior con su ID de usuario exacto de Nextcloud. El ID de usuario no es necesariamente el nombre para mostrar ni la dirección de correo electrónico.

La salida de la terminal muestra el directorio de instalación de Nextcloud de ejemplo y un recordatorio para confirmar el nombre de usuario del administrador.
Paso 1: Confirme el directorio de instalación de Nextcloud y el nombre de usuario exacto de la cuenta antes de ejecutar occ.

Paso 2: Ejecutar el restablecimiento interactivo de contraseña

Para una instalación típica de Debian o Ubuntu desde el código fuente cuyo servidor web se ejecuta como www-data, ejecute esto desde el directorio de Nextcloud:

sudo -E -u www-data php occ user:resetpassword admin

Reemplace www-datasi su servidor usa un usuario HTTP diferente, y reemplace admincon el ID de cuenta que confirmó. Si aún no se encuentra en el directorio de instalación, use la ruta completa:

sudo -E -u www-data php /var/www/nextcloud/occ user:resetpassword admin

Nextcloud te pedirá que ingreses la nueva contraseña y la confirmes. Normalmente, los caracteres de la contraseña no aparecen mientras escribes; esto es normal. Ingresa la misma contraseña en ambas ocasiones. Un mensaje de confirmación indicará que Nextcloud aceptó el restablecimiento.

Terminal de Linux que muestra el comando occ user:resetpassword y las dos solicitudes de contraseña ocultas.
Paso 2: Ejecute el comando de restablecimiento interactivo como la cuenta del servidor web e introduzca la nueva contraseña dos veces.

Paso 3: Utilice una variable de entorno solo para la automatización.

Nextcloud también admite --password-from-envoperaciones mediante scripts. Lee la contraseña de la OC_PASSvariable de entorno. Evite introducir una contraseña real directamente en la línea de comandos, el historial de la consola, un script incluido en el control de versiones o una transcripción de terminal compartida.

Para una sesión de shell puntual, puede ingresar el secreto sin mostrarlo, exportarlo, ejecutar el comando documentado y luego borrarlo:

read -s OC_PASS
export OC_PASS
sudo -E -u www-data php occ user:resetpassword --password-from-env admin
unset OC_PASS

Después read -s, escriba la nueva contraseña y pulse Intro; la entrada permanecerá oculta. La -Eopción solicita a sudo que conserve el entorno, pero la política local de sudo puede restringir este comportamiento. Si el comando indica que OC_PASSfalta o está vacío, utilice el restablecimiento interactivo o siga el procedimiento de gestión de secretos de su plataforma. No desactive las medidas de seguridad de sudo solo para que funcione un script.

Terminal de Linux que muestra el comando --password-from-env reset después de una nota que indica que OC_PASS está configurado de forma segura.
Para los restablecimientos mediante scripts, Nextcloud admite la opción de contraseña del entorno; no introduzca una contraseña real en un comando o artículo.

Paso 4: Verificar que la cuenta pueda iniciar sesión

Abre tu URL habitual de Nextcloud en una ventana de incógnito o cierra la sesión actual. A continuación, inicia sesión con el mismo ID de cuenta y la nueva contraseña. Un inicio de sesión correcto confirma que las credenciales funcionan a través de la aplicación web, no solo que se ejecutó el comando de la CLI. Si tu organización utiliza un segundo factor de autenticación, completa también ese desafío habitual.

Formulario de inicio de sesión del navegador para una cuenta de Nextcloud llamada admin con el campo de contraseña oculto.
Paso 4: Pruebe las nuevas credenciales en la página de inicio de sesión habitual de Nextcloud.

Problemas comunes y cómo responder

  • Could not open input file: occo un error de archivo faltante: Probablemente se encuentre en el directorio incorrecto o esté utilizando la ruta incorrecta. Localice el occarchivo instalado y vuelva a ejecutar el comando allí.
  • Errores de permisos o propiedad: Verifique la cuenta del servidor web/PHP de su distribución y ejecute el comando con esa cuenta. No cambie la propiedad de forma recursiva como solución rápida; esto puede generar problemas de acceso más amplios.
  • Si aparece el mensaje "El usuario no existe" o un error similar, confirme el ID de la cuenta, respetando las mayúsculas y minúsculas. No utilice una dirección de correo electrónico como sustituto, a menos que sea el ID de la cuenta.
  • phpFalta o se ha seleccionado una versión incorrecta de PHP: utilice el binario de la CLI de PHP compatible con su instalación de Nextcloud y su plataforma de alojamiento. Un servidor puede tener más de una instalación de PHP, por lo que no asuma que el comando predeterminado coincide con el entorno de ejecución web.
  • El servidor se ejecuta en Docker, Nextcloud AIO, Snap o un dispositivo virtual: ejecútelo occen el entorno de la aplicación y siga el procedimiento de comandos oficial de esa implementación. La ruta del host, el nombre del contenedor y el usuario de ejecución difieren; un comando a nivel de host copiado de una instalación de origen puede apuntar al sistema de archivos incorrecto.
  • La cuenta se gestiona mediante LDAP o Active Directory: estos sistemas pueden ser la autoridad para las credenciales de la cuenta. Es posible que un restablecimiento de contraseña local de Nextcloud no actualice una contraseña gestionada externamente. Siga el procedimiento de restablecimiento del administrador del directorio y verifique la configuración de su proveedor de identidad.
  • No tienes acceso a la consola: intenta usar el enlace para restablecer la contraseña en la página de inicio de sesión si la cuenta tiene una dirección de correo electrónico válida guardada en Nextcloud, o pídele a otro administrador de Nextcloud o a tu proveedor de alojamiento que la restablezca.

Qué evitar después de la recuperación

No edite directamente la base de datos de Nextcloud para reemplazar el hash de una contraseña. No cambie la contraseña del sistema operativo esperando que esto restablezca un usuario de Nextcloud. Mantenga la nueva contraseña en secreto, elimine cualquier secreto temporal del entorno de la consola y guárdela en su gestor de contraseñas. Si sospecha que la credencial anterior estuvo expuesta, revise el acceso a través del proceso de seguridad habitual de su organización.

Referencias oficiales

Nextcloud documenta las opciones de recuperación y el procedimiento para restablecer una contraseña de administrador perdida en Restablecer una contraseña de administrador perdida . El comando compatible, las solicitudes de contraseña y la opción de variable de entorno se describen en Comandos de usuario y grupo y Uso del comando occ .

Dejar un comentario

Solucionar el problema de la carga automática de Nextcloud en iOS que no funciona en segundo plano

Solucionar el problema de la carga automática de Nextcloud en iOS que no funciona en segundo plano

Si Nextcloud para iPhone solo sube archivos cuando está abierto, compruebe la configuración de Carga automática, la Actualización en segundo plano de la aplicación de iOS, el acceso a Fotos, el Modo de bajo consumo, los límites de red y los errores del servidor con esta práctica lista de verificación.

Cómo configurar el visor de archivos de Kopano WebApp y los complementos MDM

Cómo configurar el visor de archivos de Kopano WebApp y los complementos MDM

Aprenda cómo habilitar las vistas previas de archivos de Kopano WebApp e instalar el complemento MDM, con los requisitos de Z-Push y PHP SOAP, comprobaciones de configuración y pruebas de seguridad de dispositivos.

Solucionar el error “Límite de memoria PHP por debajo del valor recomendado” en ownCloud 10

Solucionar el error “Límite de memoria PHP por debajo del valor recomendado” en ownCloud 10

Solucione correctamente la advertencia de límite de memoria PHP de ownCloud 10 encontrando la configuración PHP web activa, estableciendo 512M, gestionando la CLI y Docker, y verificando el espacio de RAM disponible.

Solucionar el error 500 del servidor interno en el panel de control de BigBlueButton Greenlight

Solucionar el error 500 del servidor interno en el panel de control de BigBlueButton Greenlight

Solucione el error 500 del panel de control de Greenlight identificando su versión, revisando los registros de la aplicación, verificando la configuración de la API y la base de datos de BBB y revisando la configuración del proxy.

Cómo configurar alias de salas Matrix personalizadas en su dominio

Cómo configurar alias de salas Matrix personalizadas en su dominio

Aprende cómo funcionan los alias de sala de Matrix, prepara tu dominio y el servidor principal de Synapse, configura la delegación de federación, crea un alias personalizado y verifícalo de forma segura.

Cómo transferir la propiedad de archivos compartidos en ownCloud Server

Cómo transferir la propiedad de archivos compartidos en ownCloud Server

Aprende cómo un administrador de ownCloud Server puede transferir una carpeta seleccionada o todos los archivos a otro usuario con occ, teniendo en cuenta los recursos compartidos, las versiones y la verificación.

Solucionar el aviso de Nextcloud "Algunos archivos no han superado la comprobación de integridad".

Solucionar el aviso de Nextcloud "Algunos archivos no han superado la comprobación de integridad".

Aprende a diagnosticar las advertencias de integridad del código de Nextcloud, restaurar los archivos principales modificados o faltantes, gestionar los archivos adicionales y los errores de firma de la aplicación, y luego verificar la reparación de forma segura.

Solucionar el problema del cliente de sincronización de escritorio de Nextcloud que se queda atascado en "Procesando archivos".

Solucionar el problema del cliente de sincronización de escritorio de Nextcloud que se queda atascado en "Procesando archivos".

¿Nextcloud Desktop se queda atascado en "Procesando archivos"? Diagnostica el archivo que causa el bloqueo, la configuración de sincronización, la red, los registros y las opciones de restablecimiento seguro sin poner en riesgo tus datos.

Cómo restablecer una contraseña de administrador de Nextcloud con OCC

Cómo restablecer una contraseña de administrador de Nextcloud con OCC

Restablezca una contraseña de administrador de Nextcloud olvidada desde la línea de comandos con occ. Encuentre la ruta de instalación correcta, ejecute el restablecimiento de forma segura y verifique el acceso.

Cómo configurar un servidor de grabación y transmisión Jibri para Jitsi Meet

Cómo configurar un servidor de grabación y transmisión Jibri para Jitsi Meet

Configura Jibri con Docker Compose para Jitsi Meet. Configura la grabación, protege los permisos de almacenamiento, inicia el servicio y prueba las grabaciones y las transmisiones RTMP.