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