Skip to main content
Configuration

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

Figure 11-1
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. Verification: The selected values remain after reopening the page.

Configure System Settings

Figure 11-2
SettingBehavior when enabledRecommendation
Auto-start on bootAutomatically starts the QoderWake background process at system loginEnable if you frequently use local Wakers or automated tasks
Keep system awakePrevents the computer from sleeping during conversations or automated tasksRecommended for devices running long-running or scheduled tasks
Allow remote configuration managementAllows other devices to modify Waker, skill, and connector configurationsEnable 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. Verification: Switch states remain unchanged after reopening the page.

Run Network Diagnostics

Figure 11-3
  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

Figure 11-4
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.