> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langdock.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Workspace Setup

> Configure your Langdock workspace from initial setup to full customization. This guide covers security, branding, capabilities, and user management.

## Security: SAML and SCIM

If you're using an identity access management (IAM) solution like Microsoft Entra or Okta, start by setting up SAML 2.0 and SCIM in the [security settings](https://app.langdock.com/settings/workspace/security). See dedicated guides for [Microsoft Entra](https://docs.langdock.com/en/admin/security/saml/entra.md) or [Okta](https://docs.langdock.com/en/admin/security/saml/okta.md).

To let people outside verified domains sign in without SAML, enable [Allow External Authentication](https://docs.langdock.com/en/admin/security/saml/saml.md#password-login-and-saml).

Additional security options:

* **Domain-based access**: Allow users with specific email domains to join automatically
* **IP restrictions**: Limit workspace access to specific IP ranges (CIDR notation)
* **User invitations**: Control whether existing members can invite new users

## Member, Group and Role Settings

**Members:** Manage users in [member settings](https://app.langdock.com/settings/workspace/user-management/members) to change roles, invite users manually, assign custom roles or extra permissions, or assign [Business and Business Max plans](https://docs.langdock.com/en/admin/manage-usage/plans.md).

**Roles:** Configure system roles and create custom roles in [roles settings](https://app.langdock.com/settings/workspace/user-management/roles). Start with default permissions and adjust as needed. See [Roles and extra permissions](https://docs.langdock.com/en/admin/workspace/roles.md) and [Permission Recommendations](https://docs.langdock.com/en/admin/workspace/permissions.md).

**Groups:** Create groups for teams or departments in [group settings](https://app.langdock.com/settings/workspace/user-management/groups). Groups can sync from your IAM solution via SCIM. Workspace admins can turn on **Grant extra permissions to group members**. Most of those grants apply across the workspace. **View governance** on a group is limited to resources owned by people in that group.

## General Workspace Settings

Configure basic workspace identity in [general settings](https://app.langdock.com/settings/workspace/general):

* **Workspace icon**: Upload your company logo (displayed at 96x96px)
* **Workspace name**: Your company or team name
* **Company description**: Short, company-wide facts that stay true across chats and teams (up to 10,000 characters). Langdock sends it with regular chats unless the chat uses an Agent or Project. Put task-specific context on a Skill, Agent, or Project.

## Branding & Customization

Customize your workspace appearance in [customization settings](https://app.langdock.com/settings/workspace/customizations):

**Visual branding:**

* **Primary color**: Your brand hex color for buttons and highlights
* **Home background image**: Custom image for the home screen
* **Greeting text color**: Text color options appear after a home background image is set
* **Favicon URL**: Custom favicon (dedicated deployments only)
* **Logo options**: Show workspace logo in new chats, replace model logos with workspace logo

**Chat settings:**

* **Chat disclaimer**: Warning text below the input field (max 128 characters)

**Info boxes:** Up to 3 boxes on the home screen with icon, title, description, and optional button link.

**Custom navigation links:** Up to 4 links in the sidebar with predefined icons (link, help, support, info, idea, file, bug, confetti, star).

**Prompt recommendations:** Up to 20 suggested prompts displayed to users.

**Sharing disclaimers:**

* Agent sharing disclaimer (max 280 characters, Markdown supported)
* Folder sharing disclaimer (max 280 characters, Markdown supported)

## Model Configuration

Configure default and available models in [model settings](https://app.langdock.com/settings/workspace/models):

* **Default chat model**: Model used for new conversations
* **Default image generation model**: Model for image creation
* **Default embedding model**: Model for knowledge processing
* **Deep research models**: Backbone, reasoning, and fast reasoning models (BYOK only)
* **Active models**: Enable or disable specific models for your workspace

## Product Capabilities

Control which features are available to users:

**Chat capabilities** ([chat settings](https://app.langdock.com/settings/workspace/products/chat)):

* Web search
* Image generation
* Create & work with files
* Document Editor
* Chat sharing
* Memory (and whether enabled by default)
* Transcription

**Agent capabilities** ([agent settings](https://app.langdock.com/settings/workspace/products/assistants)):

* Web search, image generation, Create & work with files, Document Editor
* Source restriction
* Share requests
* User info sharing
* Tracing configuration
* Auto archive unused agents ([archive settings](https://docs.langdock.com/en/admin/manage-agents/archive-agents.md))

**Workflow settings:**

* Code node, HTTP node, and Web search node access
* Spend limits (per workflow and workspace-wide)

## Product Access Control

For each product (Chat, Agents, Workflows, Deep Research, Company Knowledge), configure:

* General access for all workspace members
* Restricted access for specific roles or groups
* Data retention period for chats

## Filling the Prompt and Agent Libraries

Give users a head start with example use cases:

* Add workspace-level agents (help chatbots, specialized agents)
* Create shared prompts (email templates, grammar correction, translation)
* Find inspiration in [agent templates](https://docs.langdock.com/resources/agent-templates.md)

Present these in onboarding workshops and check-ins with your users.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.