部署与运维
User management
User management in n8n allows you to invite people to work in your n8n instance.
This document describes how to configure your n8n instance to support user management, and the steps to start inviting users.
Refer to the main User management guide for more information about usage, including:
For LDAP setup information, refer to LDAP.
For SAML setup information, refer to SAML.
Setup
There are three stages to set up user management in n8n:
- Configure your n8n instance to use your SMTP server.
- Start n8n and follow the setup steps in the app.
- Invite users.
Step one: SMTP
n8n recommends setting up an SMTP server, for user invites and password resets.
Get the following information from your SMTP provider:
- Server name
- SMTP username
- SMTP password
- SMTP sender name
To set up SMTP with n8n, configure the SMTP environment variables for your n8n instance. For information on how to set environment variables, refer to Configuration
| Variable | Type | Description | Required? |
|---|---|---|---|
N8N_EMAIL_MODE |
string | smtp |
Required |
N8N_SMTP_HOST |
string | your\_SMTP\_server\_name | Required |
N8N_SMTP_PORT |
number | your\_SMTP\_server\_port Default is 465. |
Optional |
N8N_SMTP_USER |
string | your\_SMTP\_username | Optional |
N8N_SMTP_PASS |
string | your\_SMTP\_password | Optional |
N8N_SMTP_OAUTH_SERVICE_CLIENT |
string | your\_OAuth\_service\_client | Optional |
N8N_SMTP_OAUTH_PRIVATE_KEY |
string | your\_OAuth\_private\_key | Optional |
N8N_SMTP_SENDER |
string | Sender email address. You can optionally include the sender name. Example with name: n8n <contact@n8n.com> |
Required |
N8N_SMTP_SSL |
boolean | Whether to use SSL for SMTP (true) or not (false). Defaults to true. |
Optional |
N8N_UM_EMAIL_TEMPLATES_INVITE |
string | Full path to your HTML email template. This overrides the default template for invite emails. | Optional |
N8N_UM_EMAIL_TEMPLATES_PWRESET |
string | Full path to your HTML email template. This overrides the default template for password reset emails. | Optional |
N8N_UM_EMAIL_TEMPLATES_WORKFLOW_SHARED |
String | Overrides the default HTML template for notifying users that a credential was shared. Provide the full path to the template. | Optional |
N8N_UM_EMAIL_TEMPLATES_CREDENTIALS_SHARED |
String | Overrides the default HTML template for notifying users that a credential was shared. Provide the full path to the template. | Optional |
N8N_UM_EMAIL_TEMPLATES_PROJECT_SHARED |
String | Overrides the default HTML template for notifying users that a project was shared. Provide the full path to the template. | Optional |
If your n8n instance is already running, you need to restart it to enable the new SMTP settings.
Step two: In-app setup
When you set up user management for the first time, you create an owner account.
- Open n8n. The app displays a signup screen.
- Enter your details. Your password must be at least eight characters, including at least one number and one capital letter.
- Click Next. n8n logs you in with your new owner account.
Pre-provision the instance owner from environment variables
You can pre-provision the instance owner from environment variables instead of going through the in-app setup. Set N8N_INSTANCE_OWNER_MANAGED_BY_ENV to true and provide the owner details. See Manage instance settings using environment variables for how the activation pattern works.
To change the owner email after setup, see Change the instance owner email for self-hosted n8n.
| Variable | Type | Default | Description |
|---|---|---|---|
N8N_INSTANCE_OWNER_MANAGED_BY_ENV |
Boolean | false |
Set to true to manage the instance owner from environment variables. When true, n8n overwrites the instance owner details below on every startup, locks the UI control for that user, and rejects API writes. |
N8N_INSTANCE_OWNER_EMAIL |
String | - | Email address for the instance owner. |
N8N_INSTANCE_OWNER_FIRST_NAME |
String | - | First name for the instance owner. |
N8N_INSTANCE_OWNER_LAST_NAME |
String | - | Last name for the instance owner. |
N8N_INSTANCE_OWNER_PASSWORD_HASH |
String | - | Bcrypt hash of the instance owner's password. Setting a plaintext password breaks login. |
Step three: Invite users
You can now invite other people to your n8n instance.
- Sign into your workspace with your owner account. (If you are in the Admin Panel open your Workspace from the Dashboard)
- Click the three dots next to your user icon at the bottom left and click Settings. n8n opens your Personal settings page.
- Click Users to go to the Users page.
- Click Invite.
- Enter the new user's email address.
- Click Invite user. n8n sends an email with a link for the new user to join.
官方原文和授权
本页来自 N8N 英文官方网站固定快照，并转换成 xueai 静态页面。内容以 N8N 持续更新的官方页面为准。