Skip to content

2.14. Settings

The Settings page is your central hub for configuring all aspects of Backend.AI GO. Access it by clicking the Settings (gear) icon in the sidebar.

Overview

Settings page Settings page

Settings are organized in a left sidebar with three groups:

App

Section Description
General Language, timestamp format, and general preferences
Appearance Theme, color scheme, sidebar, system tray, and UI scaling
Models Model directory, default models, and disk usage
Generation Default inference parameters and reasoning effort
Tools & extensions Tool permissions, MCP servers, and plugin configuration
Demo Demo scenarios and sample content
Advanced Network settings, logging, and developer options

Agent

Section Description
Memory Persistent memory system and namespace management
Supervisor Agent supervision and safety policies
Policies Governance and usage policies
ACP Agent Communication Protocol settings

System

Section Description
Connectors External connector configuration
Nodes Multi-node cluster configuration

Use the Search settings bar at the top to quickly find any setting by keyword.

Appearance

Theme

Backend.AI GO offers multiple visual themes to suit your preference:

  • Glass: A modern, translucent design with frosted glass effects.

  • Stained: A vibrant, colorful theme with gradient accents.

Stained theme Stained theme

Color Scheme

Choose between:

  • Light: Bright background with dark text.
  • Dark: Dark background with light text, easier on the eyes in low-light environments.
  • System: Automatically follows your operating system's appearance setting.
  • Collapse sidebar by default: When enabled, the sidebar starts collapsed to maximize content area. Hover or click the expand button to reveal it.

System Tray

  • Show system tray icon: Display an icon in the system tray (menu bar on macOS) for quick access to Backend.AI GO without keeping the main window open.

Accessibility

  • Reduce motion: Disables theme transitions and animations. This overrides the system preference and is useful for users who experience motion sensitivity.

UI Scale

Adjust the interface zoom level to make everything larger or smaller. The slider ranges allow fine-tuning for your display and preference. Click Reset to 100% to return to the default scale.

General

Language

Choose the interface language. Backend.AI GO supports:

  • English
  • Korean (한국어)

Timestamps

Configure how message timestamps are displayed throughout the application. See Chat Interface > Timestamp Display for details.

Models

For model-specific settings such as loading parameters and generation defaults, see Model Settings & Parameters.

Generation

The Generation section contains inference parameters and conversation behavior settings.

  • Restore last chat session on entry: When enabled (the default), navigating to the chat screen without an active session automatically reopens your most recently updated conversation. Disable this if you prefer to always start at a blank chat.

See Conversation Management > Session Restore for more details.

Tools & Extensions

Configure tool permissions and MCP (Model Context Protocol) servers. See MCP Integration for details.

Memory

The Memory section configures the persistent memory system. For a complete guide to memory banks, the Memory Viewer, auto-extraction, and memory injection, see Memory.

Advanced

The Advanced section contains network settings, logging, and developer options.

Port Ranges

Backend.AI GO binds several local TCP port pools. You normally never need to touch these, but if another application reserves the defaults — most commonly WSL2/Hyper-V on Windows — you can move the pools to a free range here.

  • Inference Server Ports: The port pool for local inference servers (llama-server). Default 3900039019.
  • System Monitor Ports: The port pool for the system monitor service (all-smi). Default 3950039509.

The API server / router port is configured separately under Settings → API → Port (default 39080).

Restart required

Changes to the port ranges take effect when the affected service restarts.

If you hit a "No available ports" error — especially on Windows with WSL2 — see Troubleshooting → Windows/WSL2 port conflicts for the diagnostic command and the recommended workarounds.