diff --git a/src/pages/get-started/install/docker.mdx b/src/pages/get-started/install/docker.mdx index e5cc3bff..c9fd8cc6 100644 --- a/src/pages/get-started/install/docker.mdx +++ b/src/pages/get-started/install/docker.mdx @@ -85,6 +85,7 @@ volumes: ## Running NetBird with a Setup Key In case you are activating a server peer, you can use a [setup key](/manage/peers/register-machines-using-setup-keys) as described in the steps below. + > This is especially helpful when you are running multiple server instances with infrastructure-as-code tools like ansible and terraform. For unattended deployments across many containers, pre-populate the client config and inject the setup key at runtime. See [Bootstrap peers via config file](/manage/peers/bootstrap-via-config-file). diff --git a/src/pages/get-started/install/index.mdx b/src/pages/get-started/install/index.mdx index 6c5e81ba..b189963a 100644 --- a/src/pages/get-started/install/index.mdx +++ b/src/pages/get-started/install/index.mdx @@ -34,7 +34,10 @@ Alternatively, you could use command line. Simply run ```bash netbird up ``` -> It will open your browser, and you will be prompt for email and password. Follow the instructions. + + + It will open your browser and prompt you for your email and password. Follow the instructions. +

high-level-dia @@ -47,6 +50,7 @@ Check connection status: ## Running NetBird with a Setup Key In case you are activating a server peer, you can use a [setup key](/manage/peers/register-machines-using-setup-keys) as described in the steps below. + > This is especially helpful when you are running multiple server instances with infrastructure-as-code tools like ansible and terraform. 1. Login to the Management Service. You need to have a `setup key` in hand (see [setup keys](/manage/peers/register-machines-using-setup-keys)). @@ -60,14 +64,19 @@ For **Docker**, you can run with the following command: ```bash docker run --network host --privileged --rm -d -e NB_SETUP_KEY= -v netbird-client:/var/lib/netbird netbirdio/netbird: ``` -> TAG > 0.6.0 version + + + Replace `` with a version newer than 0.6.0. + Alternatively, if you are hosting your own Management Service provide `--management-url` property pointing to your Management Service: ```bash netbird up --setup-key --management-url http://localhost:33073 ``` -> You could also omit the `--setup-key` property. In this case, the tool will prompt for the key. + + You could also omit the `--setup-key` property. In this case, the tool will prompt for the key. + 2. Check connection status: ```bash diff --git a/src/pages/get-started/install/linux.mdx b/src/pages/get-started/install/linux.mdx index d5665a8a..0f3abf52 100644 --- a/src/pages/get-started/install/linux.mdx +++ b/src/pages/get-started/install/linux.mdx @@ -464,7 +464,10 @@ Alternatively, you could use command line. Simply run ```bash netbird up ``` -> It will open your browser, and you will be prompt for email and password. Follow the instructions. + + + It will open your browser and prompt you for your email and password. Follow the instructions. +

high-level-dia @@ -477,6 +480,7 @@ Check connection status: ## Running NetBird with a Setup Key In case you are activating a server peer, you can use a [setup key](/manage/peers/register-machines-using-setup-keys) as described in the steps below. + > This is especially helpful when you are running multiple server instances with infrastructure-as-code tools like ansible and terraform. For unattended deployments across many machines, pre-populate the client config so each peer registers on first start. See [Bootstrap peers via config file](/manage/peers/bootstrap-via-config-file). @@ -492,7 +496,9 @@ Alternatively, if you are hosting your own Management Service provide `--managem netbird up --setup-key --management-url http://localhost:33073 ``` -> You could also omit the `--setup-key` property. In this case, the tool will prompt for the key. + + You could also omit the `--setup-key` property. In this case, the tool will prompt for the key. + 2. Check connection status: ```bash diff --git a/src/pages/get-started/install/macos.mdx b/src/pages/get-started/install/macos.mdx index 3322afce..aafe7824 100644 --- a/src/pages/get-started/install/macos.mdx +++ b/src/pages/get-started/install/macos.mdx @@ -21,7 +21,10 @@ _If you require an older version checkout NetBird [releases](https://github.com/ 2. Proceed with the installation steps 3. This will install the NetBird app into /Applications and add the daemon service 4. After installing, you can follow the steps from [Running NetBird with SSO Login](#Running-NetBird-with-SSO-Login) steps. -> To uninstall the client remove the app from /Applications + + + To uninstall the client remove the app from /Applications + ### Homebrew install @@ -34,7 +37,10 @@ sudo netbird service uninstall # unlink the app brew unlink netbird ``` -> netbird will copy any existing configuration from the netbird's default configuration paths to the new NetBird's default location + + + netbird will copy any existing configuration from the netbird's default configuration paths to the new NetBird's default location + 3. Install the client ```bash @@ -118,7 +124,10 @@ Alternatively, you could use command line. Simply run ```bash netbird up ``` -> It will open your browser, and you will be prompt for email and password. Follow the instructions. + + + It will open your browser and prompt you for your email and password. Follow the instructions. +

high-level-dia @@ -131,6 +140,7 @@ Check connection status: ### Running NetBird with a Setup Key In case you are activating a server peer, you can use a [setup key](/manage/peers/register-machines-using-setup-keys) as described in the steps below. + > This is especially helpful when you are running multiple server instances with infrastructure-as-code tools like ansible and terraform. For unattended deployments across many machines, pre-populate the client config so each peer registers on first start. See [Bootstrap peers via config file](/manage/peers/bootstrap-via-config-file). @@ -146,7 +156,9 @@ Alternatively, if you are hosting your own Management Service provide `--managem netbird up --setup-key --management-url http://localhost:33073 ``` -> You could also omit the `--setup-key` property. In this case, the tool will prompt for the key. + + You could also omit the `--setup-key` property. In this case, the tool will prompt for the key. + 2. Check connection status: ```bash diff --git a/src/pages/get-started/install/synology.mdx b/src/pages/get-started/install/synology.mdx index 04d0593b..f4ea1cf4 100644 --- a/src/pages/get-started/install/synology.mdx +++ b/src/pages/get-started/install/synology.mdx @@ -60,6 +60,7 @@ fi ## Running with a Setup Key In case you are activating a server peer, you can use a [setup key](/manage/peers/register-machines-using-setup-keys) as described in the steps below. + > This is especially helpful when you are running multiple server instances with infrastructure-as-code tools like ansible and terraform. 1. Login to the Management Service. You need to have a `setup key` in hand (see [setup keys](/manage/peers/register-machines-using-setup-keys)). @@ -73,7 +74,9 @@ Alternatively, if you are hosting your own Management Service provide `--managem netbird up --setup-key --management-url http://localhost:33073 ``` -> You could also omit the `--setup-key` property. In this case, the tool will prompt for the key. + + You could also omit the `--setup-key` property. In this case, the tool will prompt for the key. + 2. Check connection status: ```bash diff --git a/src/pages/get-started/install/windows.mdx b/src/pages/get-started/install/windows.mdx index 00b17170..2fcca95c 100644 --- a/src/pages/get-started/install/windows.mdx +++ b/src/pages/get-started/install/windows.mdx @@ -109,7 +109,10 @@ Alternatively, you could use command line. Simply run ```bash netbird up ``` -> It will open your browser, and you will be prompt for email and password. Follow the instructions. + + + It will open your browser and prompt you for your email and password. Follow the instructions. +

high-level-dia @@ -122,6 +125,7 @@ Check connection status: ## Running NetBird with a Setup Key In case you are activating a server peer, you can use a [setup key](/manage/peers/register-machines-using-setup-keys) as described in the steps below. + > This is especially helpful when you are running multiple server instances with infrastructure-as-code tools like ansible and terraform. For unattended deployments across many machines, pre-populate the client config so each peer registers on first start. See [Bootstrap peers via config file](/manage/peers/bootstrap-via-config-file). @@ -138,7 +142,9 @@ Alternatively, if you are hosting your own Management Service provide `--managem netbird up --setup-key --management-url http://localhost:33073 ``` -> You could also omit the `--setup-key` property. In this case, the tool will prompt for the key. + + You could also omit the `--setup-key` property. In this case, the tool will prompt for the key. + 2. Check connection status: ```bash diff --git a/src/pages/manage/for-partners/acronis-integration.mdx b/src/pages/manage/for-partners/acronis-integration.mdx index 924f1471..ae47ef97 100644 --- a/src/pages/manage/for-partners/acronis-integration.mdx +++ b/src/pages/manage/for-partners/acronis-integration.mdx @@ -48,7 +48,9 @@ This access policy will automatically apply to all devices managed by Acronis Cy Moreover, users will only gain this network access when their devices are actively monitored and maintained through Acronis Cyber Protect Cloud, creating a comprehensive security approach where device health monitoring and network access controls work together. This combination ensures that only properly managed and compliant devices can establish secure network connections to protected resources. -> **Note**: For maximum security, create separate policies rather than overly broad policies for each distinct access requirement. This approach minimizes your attack surface by ensuring precise access controls aligned with job responsibilities and reducing complexity in multi-client MSP environments. + + For maximum security, create separate policies rather than overly broad policies for each distinct access requirement. This approach minimizes your attack surface by ensuring precise access controls aligned with job responsibilities and reducing complexity in multi-client MSP environments. + With these access policies configured, you can now proceed to use Acronis' software deployment capabilities to install NetBird across your managed Windows machines, ensuring that all team members have the required secure connectivity client automatically deployed and configured. @@ -81,7 +83,9 @@ In the `Install / Uninstall commands` tab, configure the silent installation par The `/S` parameter ensures silent installation without user prompts for NetBird's EXE installer, while `{{full_path}}` and `{{uninstall_cmd}}` are Acronis variables that automatically resolve to the correct paths during deployment. Click `Next` when ready. -> **Note**: If you're using NetBird's MSI installer instead of the EXE installer, use `/qn` in the **Installation options** field instead of `"{{full_path}}" /S`. The **Uninstallation options** field remains the same (`{{uninstall_cmd}} /S`) for both installer types. Starting with v0.75.0, neither installer creates a machine-wide UI autostart entry and the MSI has no `AUTOSTART` property. The desktop app manages **Launch NetBird UI at Login** per user. Use the [`disableAutostart` MDM setting](/client/mdm-integration#disableAutostart) to suppress it on managed endpoints. + + If you're using NetBird's MSI installer instead of the EXE installer, use `/qn` in the **Installation options** field instead of `"{{full_path}}" /S`. The **Uninstallation options** field remains the same (`{{uninstall_cmd}} /S`) for both installer types. Starting with v0.75.0, neither installer creates a machine-wide UI autostart entry and the MSI has no `AUTOSTART` property. The desktop app manages **Launch NetBird UI at Login** per user. Use the [`disableAutostart` MDM setting](/client/mdm-integration#disableAutostart) to suppress it on managed endpoints. + ![Install / Uninstall commands](/docs-static/img/manage/for-partners/acronis-windows-netbird-integration/acronis-windows-08.png) diff --git a/src/pages/manage/peers/mdm-deployment/intune-netbird-integration.mdx b/src/pages/manage/peers/mdm-deployment/intune-netbird-integration.mdx index 8ce06bbc..89d8b6a0 100644 --- a/src/pages/manage/peers/mdm-deployment/intune-netbird-integration.mdx +++ b/src/pages/manage/peers/mdm-deployment/intune-netbird-integration.mdx @@ -47,7 +47,9 @@ This access policy will automatically apply to all devices enrolled in Intune th Moreover, users will only gain this network access when using compliant devices that meet your organization's security standards, creating a true zero trust environment where user identity and device security status are verified before granting resource access. -> **Note**: For maximum security, create separate policies rather than overly broad policies for each distinct access requirement. This approach minimizes your attack surface by ensuring precise access controls aligned with job responsibilities. + + For maximum security, create separate policies rather than overly broad policies for each distinct access requirement. This approach minimizes your attack surface by ensuring precise access controls aligned with job responsibilities. + With these access policies in place, we can now proceed to configure the automated deployment of NetBird through Intune, ensuring that all team members have the required secure connectivity client installed on their devices. @@ -104,7 +106,9 @@ You can leave the rest of the fields empty. - **Install command:** `netbird_installer_0.43.0_windows_amd64.exe /S` - **Uninstall command:** `"%ProgramFiles%\Netbird\netbird_uninstall.exe" /S` ->**Note:** The commands above assume a standard installation using the `/S` flag to specify silent mode. Change them accordingly if you require NetBird installed on a different path. Starting with v0.75.0, the installer does not create a machine-wide UI autostart entry. The desktop app manages **Launch NetBird UI at Login** per user; use the [`disableAutostart` MDM setting](/client/mdm-integration#disableAutostart) when administrators need to suppress it. + + The commands above assume a standard installation using the `/S` flag to specify silent mode. Change them accordingly if you require NetBird installed on a different path. Starting with v0.75.0, the installer does not create a machine-wide UI autostart entry. The desktop app manages **Launch NetBird UI at Login** per user; use the [`disableAutostart` MDM setting](/client/mdm-integration#disableAutostart) when administrators need to suppress it. + For this example, leave the rest of the configuration unchanged. Note that you can change the install behavior and users' ability to uninstall NetBird if required. diff --git a/src/pages/manage/team/idp-sync/embedded/google-workspace-sync.mdx b/src/pages/manage/team/idp-sync/embedded/google-workspace-sync.mdx index 86aa951d..866085c4 100644 --- a/src/pages/manage/team/idp-sync/embedded/google-workspace-sync.mdx +++ b/src/pages/manage/team/idp-sync/embedded/google-workspace-sync.mdx @@ -75,7 +75,9 @@ To [check your organization-level permissions](https://cloud.google.com/resource * Once you've selected the organization, go to `IAM & Admin` > `IAM` in the left sidebar. This will show you a list of all users (principals) and service accounts with roles at the organization level. * Look for users with roles like `Organization Administrator`, `Organization Policy Administrator`, or other high-level roles. -> NOTE: Verifying your GCP permissions is mandatory before proceeding with the integration since you might need to disable the `iam.disableServiceAccountKeyCreation` constraint temporarily during the process. + + Verifying your GCP permissions is mandatory before proceeding with the integration since you might need to disable the `iam.disableServiceAccountKeyCreation` constraint temporarily during the process. + ![Google Workspace IAM & Admin](/docs-static/img/manage/team/idp-sync/google-workspace-sync/9ECRJqC.png) diff --git a/src/pages/manage/team/idp-sync/google-workspace-sync.mdx b/src/pages/manage/team/idp-sync/google-workspace-sync.mdx index ecaa867e..d315b1eb 100644 --- a/src/pages/manage/team/idp-sync/google-workspace-sync.mdx +++ b/src/pages/manage/team/idp-sync/google-workspace-sync.mdx @@ -66,7 +66,9 @@ To [check your organization-level permissions](https://cloud.google.com/resource * Once you've selected the organization, go to `IAM & Admin` > `IAM` in the left sidebar. This will show you a list of all users (principals) and service accounts with roles at the organization level. * Look for users with roles like `Organization Administrator`, `Organization Policy Administrator`, or other high-level roles. -> NOTE: Verifying your GCP permissions is mandatory before proceeding with the integration since you might need to disable the `iam.disableServiceAccountKeyCreation` constraint temporarily during the process. + + Verifying your GCP permissions is mandatory before proceeding with the integration since you might need to disable the `iam.disableServiceAccountKeyCreation` constraint temporarily during the process. + ![Google Workspace IAM & Admin](/docs-static/img/manage/team/idp-sync/google-workspace-sync/9ECRJqC.png) diff --git a/src/pages/use-cases/cloud/aws-ecs-terraform.mdx b/src/pages/use-cases/cloud/aws-ecs-terraform.mdx index f8ffb61a..74059203 100644 --- a/src/pages/use-cases/cloud/aws-ecs-terraform.mdx +++ b/src/pages/use-cases/cloud/aws-ecs-terraform.mdx @@ -40,7 +40,10 @@ This allows you to: * An [AWS account](https://aws.amazon.com/free/). * Your AWS credentials. You can [create a new Access Key on this page](https://console.aws.amazon.com/iam/home?#/security_credentials). ### Notice -> Before getting started with this example, be aware that creating the resources from it may incur charges from AWS. + + + Before getting started with this example, be aware that creating the resources from it may incur charges from AWS. + ### Getting started diff --git a/typography.js b/typography.js index af30702d..5915d5a4 100644 --- a/typography.js +++ b/typography.js @@ -165,26 +165,13 @@ module.exports = ({ theme }) => ({ // Quotes blockquote: { - fontWeight: '500', fontStyle: 'italic', color: 'var(--tw-prose-quotes)', - borderLeftWidth: '0.375rem', - borderLeftColor: theme('colors.orange.500'), - backgroundColor: theme('colors.orange.50 / 0.3'), - quotes: '"\\201C""\\201D""\\2018""\\2019"', - marginTop: theme('spacing.8'), - marginBottom: theme('spacing.8'), - paddingTop: theme('spacing.4'), - paddingRight: theme('spacing.4'), - paddingBottom: theme('spacing.4'), + borderLeftWidth: '2px', + borderLeftColor: 'var(--tw-prose-quote-borders)', paddingLeft: theme('spacing.5'), - borderRadius: theme('borderRadius.md'), - }, - 'blockquote p:first-of-type::before': { - content: 'open-quote', - }, - 'blockquote p:last-of-type::after': { - content: 'close-quote', + marginTop: theme('spacing.6'), + marginBottom: theme('spacing.6'), }, // Headings @@ -408,10 +395,6 @@ module.exports = ({ theme }) => ({ '--tw-prose-td-borders': 'var(--tw-prose-invert-td-borders)', '--tw-prose-th-bg': 'var(--tw-prose-invert-th-bg)', '--tw-prose-td-bg': 'var(--tw-prose-invert-td-bg)', - blockquote: { - borderLeftColor: theme('colors.orange.400'), - backgroundColor: theme('colors.orange.900 / 0.2'), - }, }, }, })