> For the complete documentation index, see [llms.txt](https://docs.pharos.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pharos.ai/configuration-guide/advanced/pharos-running-user.md).

# Pharos Running User

Change the Pharos running user from the Advanced settings in Pharos Admin by resetting Pharos to run in the context of the current user.

The running user is the Salesforce user under which Pharos executes background operations. You set it during [Quick Start](https://docs.pharos.ai/configuration-guide/quick-start.md). Use this Advanced screen to change it when the current user is being deactivated or you want to switch to a dedicated integration user.

{% hint style="info" %}
For the running user concept, required permissions, and choosing the right user, see [Pharos Running User](https://docs.pharos.ai/configuration-guide/the-basics/pharos-running-user.md).
{% endhint %}

***

## Accessing the Page

Navigate to **Pharos App → Pharos Admin → Advanced → Pharos Running User**. The page shows who Pharos currently runs as, a **Reset** action, and the jobs and email service tied to that user.

![Pharos Running User page — current running user, Reset button, scheduled jobs, and email service context](https://4264222071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdl9tmJ56lvwg5XY63QYr%2Fuploads%2Fgit-blob-dface7856501e88ec2ba3a2fa4c4c50d6c6a14a6%2Fpharos-running-user-page.png?alt=media)

The page has three parts:

* **Current user** — a line stating who Pharos is running as (for example, *"Pharos is currently running as: Pharos Admin"*).
* **Scheduled Jobs** — the background schedulers (such as `PharosLogServiceSchedulerMode1` and `Mode2`), who submitted them, and their next run. A quick way to confirm Pharos's jobs are scheduled under the running user.
* **Email Service** — the inbound error-email handler (`ErrorEmailHandlerAddress`) and its **context user**, which should match the running user.

***

## Changing the Running User

Pharos runs as whoever is logged in when you press **Reset**—there is no separate user picker. To change the running user, sign in as the target user first:

1. **Log in** to Salesforce as the user you want Pharos to run as. Confirm they have the [required permissions](https://docs.pharos.ai/configuration-guide/the-basics/pharos-running-user.md#required-permissions).
2. Open **Pharos Admin → Advanced → Pharos Running User**.
3. Check the current-user line to confirm you're signed in as the intended user.
4. Click **Reset**. Pharos re-points the `PharosLogServiceSchedulerMode1` and `PharosLogServiceSchedulerMode2` schedulers and the email-service context to the current user. Separately scheduled Pharos jobs keep their original submitter and must be rescheduled by hand if they need to move to the new user.

In-flight jobs may continue under the previous user until they complete.

{% hint style="warning" %}
**Plan ahead:** Reset the running user **before** deactivating the current user. Once the current user is deactivated, Pharos cannot run background processes until you reset to a valid, permissioned user.
{% endhint %}

***

## Before You Reset

Verify the target user has the **Log\_Admin** permission set assigned — it grants every permission Pharos needs for background operations, and it ships separately via the [pharos-permissions](https://resources.pharos.ai/pharos-permissions) download rather than in the managed package.

For the individual permissions Log\_Admin includes and why each is needed, see [Required Permissions](https://docs.pharos.ai/configuration-guide/the-basics/pharos-running-user.md#required-permissions).

***

## Troubleshooting

| Issue                             | Cause                                            | Resolution                                           |
| --------------------------------- | ------------------------------------------------ | ---------------------------------------------------- |
| Reset ran as the wrong user       | You weren't logged in as the intended user       | Log in as the target user, then click Reset again    |
| New user lacks access after reset | Missing permissions                              | Assign the required permission set, then reset again |
| Background jobs fail after change | Previous user deactivated or permissions revoked | Reset while logged in as a valid, permissioned user  |
| Reset button not available        | Insufficient permissions                         | Must be a System Administrator                       |

***

## Related

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>👤 Pharos Running User (Basics)</strong></td><td>Concept, permissions, choosing the right user</td><td><a href="https://docs.pharos.ai/configuration-guide/the-basics/pharos-running-user.md">Pharos Running User</a></td></tr><tr><td><strong>🚀 Quick Start</strong></td><td>Initial setup and running user assignment</td><td><a href="https://docs.pharos.ai/configuration-guide/quick-start.md">Quick Start</a></td></tr><tr><td><strong>🗺️ Configuration Overview</strong></td><td>Admin navigation and status overview</td><td><a href="https://docs.pharos.ai/configuration-guide/configuration-overview.md">Configuration Overview</a></td></tr></tbody></table>
