Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 8 additions & 21 deletions src/content/docs/maintaining-fossbilling/admin-manual-reset.mdoc
Original file line number Diff line number Diff line change
@@ -1,34 +1,21 @@
---
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.

Comment thread
admdly marked this conversation as resolved.
{% 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 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

Expand All @@ -42,7 +29,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.
Expand Down
17 changes: 0 additions & 17 deletions src/content/docs/maintaining-fossbilling/updating.mdoc
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Loading