From aba5450c735a871db03823974805e1910f9cf788 Mon Sep 17 00:00:00 2001 From: Adam Daley Date: Tue, 12 May 2026 02:11:36 +0100 Subject: [PATCH 1/2] Docs: simplify admin reset and update docs --- .../admin-manual-reset.mdoc | 25 +++---------------- .../maintaining-fossbilling/updating.mdoc | 17 ------------- 2 files changed, 4 insertions(+), 38 deletions(-) diff --git a/src/content/docs/maintaining-fossbilling/admin-manual-reset.mdoc b/src/content/docs/maintaining-fossbilling/admin-manual-reset.mdoc index 67d31c9..134dc08 100644 --- a/src/content/docs/maintaining-fossbilling/admin-manual-reset.mdoc +++ b/src/content/docs/maintaining-fossbilling/admin-manual-reset.mdoc @@ -1,34 +1,17 @@ --- -title: Manually Resetting Your Admin Password +title: Manual Admin Password Reset description: Reset your admin password directly in the database when you can't use the normal reset feature. --- -{% aside type="danger" %} -**Back up your database first.** This guide involves making direct changes to the database. If something goes wrong, you will need a backup to restore. -{% /aside %} - Use this guide when you have lost admin access and cannot use the password reset feature. These steps use phpMyAdmin, but any database tool will work — the steps will simply differ slightly. ## Step 1: Log into phpMyAdmin -Log in to phpMyAdmin using your hosting control panel credentials. Not sure how? Contact your hosting provider. +Log in to phpMyAdmin. Not sure how? Contact your hosting provider. ## Step 2: Select Your Database -Choose the database you installed FOSSBilling on. If you're not sure which one, check your `config.php` file: - -```php {6} -'db' => [ - 'type' => 'mysql', - 'host' => 'localhost', - 'port' => '3306', - 'name' => 'fossbilling', - 'user' => 'fossbilling_user', - 'password' => 'fossbilling_password', -], -``` - -![Selecting the database in phpMyAdmin](/img/guides/admin-manual-reset/pma_db.png) +Choose the database you installed FOSSBilling on. If you're not sure which one, check your `config.php` file. ## Step 3: Find the Admin Table @@ -42,7 +25,7 @@ Choose the database you installed FOSSBilling on. If you're not sure which one, ![Clicking the Edit button on your account row](/img/guides/admin-manual-reset/pma_row.png) -## Step 4: Generate a New Password Hash +## Step 4: Generate New Password Hash {% aside type="danger" title="Security Warning" %} Generate the hash on a machine you trust. Do not enter admin passwords into online hashing tools; they may store passwords and hashes. diff --git a/src/content/docs/maintaining-fossbilling/updating.mdoc b/src/content/docs/maintaining-fossbilling/updating.mdoc index 6452bfc..45506f2 100644 --- a/src/content/docs/maintaining-fossbilling/updating.mdoc +++ b/src/content/docs/maintaining-fossbilling/updating.mdoc @@ -28,21 +28,4 @@ If you prefer to manage files yourself: 5. Log in to the admin panel and go to **System** → **Update** 6. Click **Apply Patches & Update Configuration** -## Emergency Recovery - -If you cannot access the admin panel after updating, use the fallback patcher: - -1. Visit `example.com/run-patcher` in your browser -2. This runs database migrations and configuration updates automatically -3. Once complete, try logging in again - -{% aside type="tip" %} -If the patcher doesn't fix the issue, restore from your backup and try the update again. Check the [changelog](/changelog/) for any breaking changes that might require manual steps. -{% /aside %} - -## What Gets Updated - -- **Automatic updates**: Core files, database schema, configuration -- **Patches (manual step)**: Database migrations, config updates - Always run the patches after copying in new files so the database schema and configuration stay in sync with the codebase. From de41fe1aac3f6f7cda297d499e1657ea055d2d67 Mon Sep 17 00:00:00 2001 From: Adam Daley Date: Tue, 12 May 2026 02:15:18 +0100 Subject: [PATCH 2/2] Fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- .../docs/maintaining-fossbilling/admin-manual-reset.mdoc | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/src/content/docs/maintaining-fossbilling/admin-manual-reset.mdoc b/src/content/docs/maintaining-fossbilling/admin-manual-reset.mdoc index 134dc08..71a1d49 100644 --- a/src/content/docs/maintaining-fossbilling/admin-manual-reset.mdoc +++ b/src/content/docs/maintaining-fossbilling/admin-manual-reset.mdoc @@ -5,6 +5,10 @@ description: Reset your admin password directly in the database when you can't u Use this guide when you have lost admin access and cannot use the password reset feature. These steps use phpMyAdmin, but any database tool will work — the steps will simply differ slightly. +{% aside type="danger" title="Back Up Your Database First" %} +Before making any direct database changes, create a full backup of your database. If you edit the wrong value in the `admin` row or make a mistake while saving changes, you could cause irreversible data loss or lock yourself out completely. +{% /aside %} + ## Step 1: Log into phpMyAdmin Log in to phpMyAdmin. Not sure how? Contact your hosting provider.