Docs

Settings overview

The Settings home and its search, the 14 groups with every page in them, who can change what, how changes apply, and where each page is explained.

Settings is at the bottom of the rail (or press G then S). It opens on a home page: a search box across the top and a card for each of 14 groups, each listing its pages. The Settings sidebar lists the same groups, and each one folds away, so the pages you never use stay out of sight. Above the groups in the sidebar sit Try changes first (test mode) and Search settings.

The Settings home: the search box and a card for each group, with the same groups in the sidebar
The Settings home: the search box and a card for each group, with the same groups in the sidebar

Every other area also has a shortcut: the last link in its sidebar (Service desk settings, Devices settings, Backup settings and so on) opens the Settings page for that area.

Find a setting

You do not have to know where a setting lives.

  1. Open Settings.
  2. Type in Search settings: a page name, or a word from a single setting.
  3. Pick a result. Each one says whether it is a page or a setting, and for a setting, the page and card it is on.
Searching Settings for a word: each result is a page or a single setting, with where it lives
Searching Settings for a word: each result is a page or a single setting, with where it lives

The command menu (Ctrl K or Cmd K) finds settings pages by name from anywhere, for example "Settings: Device management". Every Settings page has a ? beside its title that opens its guide here.

Who can change settings

  • Your account is yours: everyone can see and change their own profile, password and two-factor, notifications and out of office.
  • Users, Roles and permissions, Single sign-on, Modules, Licence and the other pages about the install itself are for administrators only.
  • The settings of each area follow that area's permission: they need Manage in the area and the role's Module settings switch. For example, a service desk manager can change queues and SLAs without being an administrator. Settings that turn a control off stay with administrators. See Roles and permissions and What each role switch controls.

Pages you cannot change are hidden, or shown read only. Pages for modules that are switched off in Modules are hidden.

The groups

Your account

Page What it sets Guide
Profile Your name, photo and how you sign in Your profile, security and notifications
Password and two-factor Your password, two-factor and passkeys, where you are signed in, and your API tokens Your profile, security and notifications, Sessions, IP allowlists and API tokens
Notifications What reaches you where, what you follow, role defaults, ticket routing and digests Notifications
Out of office When you are away: what you would approve goes to the person standing in, and colleagues see you are away Approval rules, delegation and out of office
Mobile app Getting the Tenvara app with a QR code, the phones signed in to your account, whether your phone follows your desktop and, for administrators, what the app may do on this install Settings > Mobile app, Follow your desktop on your phone
Browser extension Filling and saving customers' credentials from your browser, and the browsers you have connected The browser extension, Browser extension settings and policy

People and access

Page What it sets Guide
Users Everyone who can sign in, their role, how they sign in and which customers they work with Users
Roles and permissions What each role can do in each area, and which customers it works with Roles and permissions
Teams Groups of staff with a lead, which work queues, get notifications and approve requests Teams, invitations and handover
Single sign-on How your team signs in: two-factor, single sign-on providers, sessions, password rules, network access, API tokens and Confirm it is you Passwords and two-factor, Single sign-on, Sessions, IP allowlists and API tokens
Approvals Request types, chains and thresholds, your approvers and out of office Approval rules, delegation and out of office

Your organisation

Page What it sets Guide
Branding Your brand and brand profiles for customers Brand profiles
Regional Country, languages, exchange rates, tax and public holidays Languages and international
Terminology Your words for tickets, customers, contacts and the rest Terminology, numbering and email templates
Numbering How ticket, quote, project and purchase order references are written Terminology, numbering and email templates
Home page The blocks each role sees on Home, and in what order Finding your way around
Trading entities The companies you invoice from Invoice layouts and trading entities

Records

Page What it sets Guide
Customers Customer types, possible duplicates, the account manager and technical lead, and contact photos Customers, sites and contacts
Customer groups Named sets of customers, for filtering and for limiting access Customer groups and scoped access
Contact roles What each of a customer's contacts is for: who receives approvals, reports, notices and surveys, and which parts of the portal a role opens Customers, sites and contacts
Custom fields Fields of your own on customers, sites, contacts, devices, tickets, contracts, quotes and projects Custom fields
Tags The one list of tags for tickets, customers, devices, articles and every other record Lists, views and records
Policies Policies by level, and device groups for every customer Policies, checks and thresholds
Sign-offs Sign-off templates customers sign in the portal Customer sign-offs
Sign-up addresses The addresses you use to sign customers up to vendors and services: your accounts domain and its mail check, a shared mailbox in your own Microsoft 365, whether customers see their sign-up mail in the portal, and how long the mail is kept Sign-up addresses for customers

Service desk

Page What it sets Guide
Ticket setup Queues, statuses, priorities, SLAs, types, categories, business hours, time, changes, rules and workflow, with templates, checklists, recurring tickets and Identity checks (how callers are verified) Ticket setup and SLAs, Verifying who a caller is
Canned responses Replies you send often, shared or personal Service desk section
Support email Support mailboxes on the Mailboxes tab, and the wording of every email Tenvara sends on the Email templates tab Email and alert tickets, Terminology, numbering and email templates
Customer portal The portal's name, home and navigation, appearance, sections, access and sign-in, notices and what customers see Customer portal settings, Portal roles
Service catalogue Request items, categories and approvers The service catalogue
Forms The shared library of forms for requests and information requests Forms and question types
Feedback Ratings when a ticket is resolved, and Net Promoter Score Customer portal and feedback
Documentation When articles are due for review, with Browser extension policy as a tab: what the browser extension does for your staff Browser extension settings and policy
Chat Live chat from your website, the portal and the tray Chat settings
Phone How calls to your support number are answered: conversation, hours and hand-over, tickets and recordings, usage and costs. Connect it with your own phone system and AI provider accounts Service desk section
External PSA Where tickets, time and contracts live: the built-in service desk is the default Service desk section

Devices and monitoring

Page What it sets Guide
Devices and agent Agent updates and rollouts, check-ins, remote session consent, session limits and agent modules Devices and agent
Remote access Session policy, access rules, recordings, quick support, the relay and the desktop viewer Remote control
Agent protection Tamper protection and admin elevation Tamper protection
Tray menu What people see when they click the agent's icon on their computer, with End-user experience as a tab: the windows and notifications people see on their computers The windows and notifications people see
Mobile devices Mobile device management for Apple and Android Mobile device management
Device lifecycle Who uses each device, maintenance mode, when a device counts as stale, new devices at enrolment and uptime targets Devices section
Device management Device roles, when patching, scripts, software and printers raise alerts, and how long work waits for a device Devices section
Assets Expected life, warranty and refresh rules Asset lifecycle and warranty
Monitoring Monitoring policies and templates Policies, checks and thresholds
Alert rules Which alerts become tickets, with Alert types as a tab Alerts into tickets and notifications
Alert remediation Which alerts offer a fix, suggest it or fix themselves Monitoring and alerts section

Cloud and infrastructure

Page What it sets Guide
Microsoft 365 The connection and app registration, checks, starters and leavers, email security, timings, Intune, contacts, configuration and service health, with the App watchlist and Approved apps tabs Microsoft 365 overview
Infrastructure When hypervisors, Docker hosts and web servers raise alerts, how long tasks and charts are kept, and how WordPress sites are updated Infrastructure overview
Network How network probes scan, when a new device raises an alert, SNMP polling and templates Network and domains
Domains and DNS Domain and certificate checks and DNS providers Network and domains
Telephony Settings for lines, phone systems, call quality and the call pop-up for your softphone, when the Telephony and connectivity module is on Telephony and connectivity

Security

Page What it sets Guide
Security monitoring Collection, network sources, syslog relays, alerting, known tools, response, integrations and digests Security overview
Vulnerabilities Where known vulnerabilities come from, how long each severity has to be fixed, alerts and how risk is accepted Security overview
Hardening Settings for device hardening, when the Device hardening module is on Hardening overview
AI readiness Scoring and alerts, with the AI tool catalogue as a tab AI readiness section

Governance and compliance

Page What it sets Guide
Governance and compliance Frameworks and checks, with Cyber Essentials settings and Compliance settings as tabs Management systems overview

Backup

Page What it sets Guide
Backup Storage locations, schedules, retention and the encryption key Setting up backup

Sales and billing

Page What it sets Guide
Sales Pipelines, opportunity types, qualification, targets, commission and suggested opportunities. People with Manage sales settings can change it without being an administrator Opportunities and pipelines
Outlook add-in The add-in's manifest and the steps to deploy it from the Microsoft 365 admin centre, so salespeople see the sender's contact, lead and deals beside an email and log it (MSP edition) The Outlook add-in
Proposals How quotes look, how long they are valid, templates and what an accepted quote does Sales section
Billing rules Work types and rates, prepaid hours, billable units, price uplifts and account on stop, with Contracts as a tab Invoicing and payments
Invoices Numbering, payment terms, sending and reminders Invoices and credit notes
Invoice layouts How invoices look Invoice layouts and trading entities
Procurement Stock locations, low stock alerts and purchase orders Procurement and stock
Number plan How the numbers in call records are read and which destination class each call is billed as Telephony and connectivity

Projects and team

Page What it sets Guide
Projects Billing of new projects, health and the close survey Projects overview
Scheduling Visits, emails, time, dispatch, leave, booking pages and calendar sync Scheduling section
People Goals, check-ins, kudos and leaderboards Goals, kudos and leaderboards
Business reviews What goes in a business review pack Business reviews
Presentations Who decks are written for, the review before they leave the team, and the brand they wear Presentations
Reports Rates, targets and fixed costs, staff cost rates, customer report and health score settings and scheduled reports Reports section
TV dashboards Wall screens and what they show TV dashboards

Automation and AI

Page What it sets Guide
Automation rules Your "when this happens, do that" rules Automation overview
Run log Every run of every rule, with failed and waiting runs Automation overview
Channels Notification channels, how rules run, on-call settings and Out-of-hours providers Notifications and channels, Out-of-hours cover per queue
AI AI assist with your own Anthropic key. Off until a key is added Setting up AI
Integrations The directory of integrations, alert sources, connectors, webhooks, the API and its limits, and datasets Integrations and the API
Developer API The API reference and your tokens Integrations and the API

Data and platform

Page What it sets Guide
Modules Which parts of Tenvara your team uses, switched on one at a time Modules
Licence A self-hosted install's licence, edition, limits and check-in Licence and updates
Updates Which version you run, what is newer, and how long an update waits for backups Updates
Migration Bringing customers, tickets, devices, documentation and backups across from the tools you use today Moving to Tenvara
Audit log Who did what, tamper evident Audit log, data retention and privacy requests
Data retention How long each kind of data is kept, the archive, legal holds and erasing inactive customers Audit log, data retention and privacy requests, Erasing a customer
Privacy requests Data subject requests, from search and export to erasure Audit log, data retention and privacy requests
Recycle bin Everything deleted in the last 30 days, with restore, and how long deleted things are kept Lists, views and records
Vault export The break-glass export of the credentials vault Vault break-glass export
Offboarding Defaults for offboarding a customer who leaves Customer offboarding
System status Tenvara's own health, queues, the install profile, the support bundle and device diagnostics System status

Pages that changed name

If you knew the older Settings menu: Security is now Password and two-factor, Sign-in is Single sign-on, Email is Support email (with Email templates as its second tab), Ticketing system is External PSA, Diagnostics is System status, and the old Automation page is Channels. Contracts is a tab of Billing rules and the AI tool catalogue is a tab of AI readiness. Automation rules and their run log now live in Settings too. Newer pages are Mobile app, Sign-up addresses and Outlook add-in, and three pages sit as tabs of another: Browser extension policy on Documentation, End-user experience on Tray menu and Identity checks on Ticket setup. Where things moved in the new menu has the full list.

How changes apply

  • Each card on a settings page has its own Save button that stays greyed out until you change something. Leaving the page without saving discards your changes. Pages with a Reset this page button can be put back to their defaults in one go.
  • A changed setting shows Changed and Reset to default, and many settings can differ for one customer or contract. Administrators can also try changes on themselves first in test mode. See The settings catalogue and overrides.
  • Permission changes apply the next time each person's session refreshes, within a few minutes.
  • Sign-in changes (two-factor policy, single sign-on, network access) are checked at every session refresh, so people who are no longer allowed in are asked to sign in again within 15 minutes.
  • Agent settings reach online agents straight away, and offline agents the next time they connect.

Server settings

A few things are not in the app because they belong to the server: the address the install answers on, outgoing mail (SMTP), the relay for remote control and how the install is sized. On a hosted instance we look after them. On a self-hosted install they live in the .env file: see Install settings and profiles and Installing self-hosted.

Was this page helpful?

Thanks for the feedback.