> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Settings

> Configure QoderWake preferences and system settings, run network diagnostics, manage environments and devices, and check for updates.

Click the gear icon in the lower-left corner to open the quick menu, then click "Settings" to enter the full settings page. The left sidebar contains "Preferences," "System Settings," "Network Diagnostics," "Manage Environments & Devices," and "Update Application."

Settings are typically auto-saved. After making a change, navigate away and return — if the new value is still displayed, the save was successful.

## Configure Preferences

<img src="https://mintcdn.com/qoder/WdEeuYQHmOxkGNIJ/images/qoderwake/fig-11-1-en.png?fit=max&auto=format&n=WdEeuYQHmOxkGNIJ&q=85&s=c04df3f086d347468020b3acb2ac31d0" alt="" width="1280" height="720" data-path="images/qoderwake/fig-11-1-en.png" />

Select the interface language, AI reply language, or theme, wait for auto-save, and re-enter this page to confirm. The AI reply language only affects the default language for new conversations.

<Tip>
  If the selected value still appears after reopening the page, the save was successful.
</Tip>

## Configure System Settings

<img src="https://mintcdn.com/qoder/WdEeuYQHmOxkGNIJ/images/qoderwake/fig-11-2-en.png?fit=max&auto=format&n=WdEeuYQHmOxkGNIJ&q=85&s=5961e3439ce22da0f3aaad46c85c09c2" alt="" width="1280" height="720" data-path="images/qoderwake/fig-11-2-en.png" />

| Setting                               | Behavior when enabled                                                       | Recommendation                                                  |
| ------------------------------------- | --------------------------------------------------------------------------- | --------------------------------------------------------------- |
| Auto-start on boot                    | Automatically starts the QoderWake background process at system login       | Enable if you frequently use local Wakers or automated tasks    |
| Keep system awake                     | Prevents the computer from sleeping during conversations or automated tasks | Recommended for devices running long-running or scheduled tasks |
| Allow remote configuration management | Allows other devices to modify Waker, skill, and connector configurations   | Enable when you need remote management                          |

Toggle the switch and wait for auto-save. Authentication credentials, tokens, and keys remain on the local machine; file and tool capabilities continue to be governed by project and permission settings.

<Tip>
  If the switch state remains unchanged after re-entering the page, the save was successful.
</Tip>

## Run Network Diagnostics

<img src="https://mintcdn.com/qoder/WdEeuYQHmOxkGNIJ/images/qoderwake/fig-11-3-en.png?fit=max&auto=format&n=WdEeuYQHmOxkGNIJ&q=85&s=f8a6d8b2d605a7a0fa75939bf3eb986b" alt="" width="1280" height="720" data-path="images/qoderwake/fig-11-3-en.png" />

1. Click "Start Diagnostics."
2. Wait for the Gateway authentication, machine registration, and Work return link checks to complete.
3. If a check fails, expand that item, note the summary and logs, fix the login, device, or network issue, then re-run the diagnostics.

<Tip>
  All three checks — Gateway authentication, machine registration, and Work return link — showing as passed indicates the network is healthy.
</Tip>

## Manage Environments & Devices

1. Click "Refresh" to verify the device name, online status, version, and number of Wakers.
2. To add a device, click "Add Device," select the operating system, copy the command, and complete installation and login on the target machine.
3. Return to the device page and refresh to confirm the new device appears. Records for offline devices that are not the current device can be removed following the on-page instructions.

<Tip>
  The new device appearing in the current account's environments and devices list with a recognizable online status indicates successful addition.
</Tip>

If the device does not appear, confirm the service and account on the target machine:

```bash theme={null}
qoderwake status
qoderwake whoami
```

Confirm the service is running and the same account is logged in, then refresh the page.

## Check for Updates and Apply New Versions

<img src="https://mintcdn.com/qoder/WdEeuYQHmOxkGNIJ/images/qoderwake/fig-11-4-en.png?fit=max&auto=format&n=WdEeuYQHmOxkGNIJ&q=85&s=0f3fcce6fa4e50e4241554c28ded3465" alt="" width="1280" height="720" data-path="images/qoderwake/fig-11-4-en.png" />

The page displays the current running version and provides a "Check for Updates" button. Note the current version, click "Check for Updates," follow the prompts to install, and restart the service after confirming no critical tasks are running.

<Tip>
  After restarting, if "Current Version" shows the target new version and the Web Console, Wakers, and task pages load normally, the update was successful.
</Tip>

You can also use the command line to check, install, and restart:

```bash theme={null}
qoderwake update --check
qoderwake update
qoderwake restart
```

If your login has expired but you only need to continue in local mode, run `qoderwake restart --force`.

<Note>
  If the update has been installed but the version remains unchanged after restarting, confirm the service has actually restarted and run `qoderwake status` to verify the running version.
</Note>