git/nextcloud-docker
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add admin password reset script and docs

Browse Source 
Co-Authored-By: Oz <oz-agent@warp.dev>
This commit is contained in:
Raghav
2026-04-17 09:06:32 +05:30
parent 08990f6420
commit d1245fac70
2 changed files with 62 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

15
README.md
View File

@ -64,6 +64,21 @@ This script will:
```bash ```bash
./scripts/renew-production-tls.sh ./scripts/renew-production-tls.sh
``` ```
## Admin password reset
List existing users:
```bash
docker exec --user www-data nextcloud-app php occ user:list
```
Reset password using helper script (interactive prompt):
```bash
./scripts/reset-admin-password.sh admin
```
Reset password non-interactively (for automation):
```bash
NEW_NEXTCLOUD_PASSWORD={{NEW_NEXTCLOUD_PASSWORD}} ./scripts/reset-admin-password.sh admin
```
You can target a different username by passing it as the first argument.
## Useful commands ## Useful commands
Start/update containers: Start/update containers:
```bash ```bash

47
scripts/reset-admin-password.sh Executable file
View File

@ -0,0 +1,47 @@
#!/usr/bin/env bash
# scripts/reset-admin-password.sh
# Reset a Nextcloud user's password in the running nextcloud-app container.
#
# Usage:
# ./scripts/reset-admin-password.sh [username]
# NEW_NEXTCLOUD_PASSWORD='new-password' ./scripts/reset-admin-password.sh [username]
#
# Default username: admin
set -euo pipefail
TARGET_USER="${1:-admin}"
CONTAINER_NAME="${NEXTCLOUD_APP_CONTAINER:-nextcloud-app}"
if [ "${TARGET_USER}" = "-h" ] || [ "${TARGET_USER}" = "--help" ]; then
echo "Usage: ./scripts/reset-admin-password.sh [username]"
echo ""
echo "Examples:"
echo " ./scripts/reset-admin-password.sh admin"
echo " NEW_NEXTCLOUD_PASSWORD='<new-pass>' ./scripts/reset-admin-password.sh admin"
exit 0
fi
if ! command -v docker >/dev/null 2>&1; then
echo "ERROR: docker is required but not installed."
exit 1
fi
if ! docker ps --format '{{.Names}}' | grep -qx "${CONTAINER_NAME}"; then
echo "ERROR: Container '${CONTAINER_NAME}' is not running."
echo "Start the stack first (e.g. docker compose up -d)."
exit 1
fi
if [ -n "${NEW_NEXTCLOUD_PASSWORD:-}" ]; then
echo "==> Resetting password for user '${TARGET_USER}' using NEW_NEXTCLOUD_PASSWORD..."
OC_PASS="${NEW_NEXTCLOUD_PASSWORD}" docker exec --user www-data -e OC_PASS "${CONTAINER_NAME}" \
php occ user:resetpassword --password-from-env "${TARGET_USER}"
echo "==> Password reset completed."
exit 0
fi
echo "==> Interactive password reset for user '${TARGET_USER}'..."
echo "You will be prompted securely for the new password."
docker exec -it --user www-data "${CONTAINER_NAME}" php occ user:resetpassword "${TARGET_USER}"
echo "==> Password reset completed."