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

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.

If the selected value still appears after reopening the page, the save was successful.

Configure System Settings

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.

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

Run Network Diagnostics

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.

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

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.

The new device appearing in the current account’s environments and devices list with a recognizable online status indicates successful addition.

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

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

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.

After restarting, if “Current Version” shows the target new version and the Web Console, Wakers, and task pages load normally, the update was successful.

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

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.

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.