Skip to content

Settings overview

Settings is one dialog with a left rail of groups and panes. This page lists every pane and points at the guide that covers it.

Who can open Settings

Site owners and admins see the whole rail. Leads see the Members & Teams group only. Everyone else has no Settings entry at all, and the keyboard shortcut does nothing for them.

Two ways in:

ActionWhere
Open SettingsYour avatar in the top bar > Settings
Open SettingsCmd/Ctrl+Shift+,
Jump straight to the planYour avatar in the top bar > Change plan (Cloud admins only)

The shortcut is remappable in Customize > Shortcuts. See Keyboard shortcuts.

Truetask Workspace settings pane with Identity, Localization and Time tracking sections

The rail, group by group

Site

PaneWhat it covers
HealthService status, version and database. See Audit, sessions and logs.
Plan CloudCurrent plan, limits, add-ons and billing. See Plans and billing.
License Self-hostedLicense key and renewal. See License.

Plan and License are mutually exclusive. A Cloud workspace shows Plan, a self-hosted instance shows License, and neither ever shows both.

General

PaneWhat it covers
WorkspaceName, logo, date and time formats, week start, time tracking policies. See Workspace.
Board statusesThe statuses a board can be in and what each one means to Overseer. See Workspace.
Custom FieldsNot a pane: selecting it opens the Custom fields manager on its Workspace tab. See Custom fields.
UploadsMaximum attachment size. See Workspace.
Network Self-hostedWhether the instance may reach the internet or private addresses. See Network policy.
Unsplash Self-hostedAn Unsplash access key so people can pick photo covers. See Workspace.
Board TemplatesWorkspace templates: rename, share, delete. See Board templates.
AutomationsEvery automation across the workspace. See Workspace.
Archived boardsRestore an archived board or delete it permanently. See Workspace.

Members & Teams

PaneWhat it covers
User DirectoryPeople, roles, passwords, ownership. See Members and agents.
AgentsEvery agent in the workspace, with a kill switch. See Members and agents.
TeamsGroups you can mention and notify. See Working together.

Audit & Security

PaneWhat it covers
Audit LogEvery recorded change, with filters and exports. See Audit, sessions and logs.
Active SessionsWho is signed in, from where, and how to sign them out. See Audit, sessions and logs.

Integrations

PaneWhat it covers
AIThe workspace AI switch, models, routing and feature policy. See AI settings.
API TokensPersonal access tokens for the REST API. See REST API.
WebhooksIncoming endpoints and outgoing subscriptions. See Webhooks.
Git ProviderConnect GitHub, GitLab or Gitea. See Git.

Server

PaneWhat it covers
SMTP Self-hostedOutgoing mail. See SMTP.
OAuth2Sign in with an external provider. See Sign-in and identity.
Active DirectorySync users from LDAP or Active Directory. See Sign-in and identity.
Backups Self-hostedScheduled and manual database snapshots. See Backups.
S3 Storage Self-hostedS3-compatible storage for files and backups. See S3 storage.
Data Retention Self-hostedHow long logs, sessions and trashed tasks are kept. See Data retention.
LogsAPI and hook logs, searchable by the ERR reference a user reports. See Audit, sessions and logs.
ExportDownload the whole workspace as a ZIP. See Exporting.

OAuth2 and Active Directory are on both

Both identity panes live in the Server group, but neither is self-hosted only. A Cloud workspace gets them too.

What the crown means

Truetask Cloud only

A pane whose feature is not part of your plan still appears in the rail, with a small crown next to its name. Opening it explains which plan unlocks it and offers a way to change plan. See Plans and billing.

Self-hosted only

There is no plan gating. Every pane is available, and no crown is ever shown.

Health at a glance

The Health pane is the fastest answer to "is something broken". It checks PocketBase, the API server and the MCP server, and reports the app version and the database version beside them.

Truetask Health settings pane listing PocketBase, API Server and MCP Server status

Getting to the docs from the app

Most panes carry a small book icon next to their description. It opens the page on this site that covers that pane.

Truetask works the same on Truetask Cloud and on your own server. Pages and sections that apply to one model only are labelled.