8.0 KiB
Customization Guide
You can customize Networking Toolbox extensively to fit your branding and user experience needs. Covering everything from UI, behaviour, branding, accessibility, localization and more.
Available Settings
- Site name, logo, and description
- Homepage and navbar layout
- Theme, primary color, font and scale
- Custom styles via CSS
- Accessibility options
- Language and localization
- Bookmarked tools
Applying Settings
Tip
The easiest way to get started, is by visiting the settings page, making your desired changes, and then exporting the configuration (at the bottom of the page). This will give you a
.envfile which you can use in your deployment.
Option #1 - Localstorage
This is what is used on networkingtoolbox.net, allowing users to set their own preferences which persists across sessions, but not across devices. These can be changed on the Settings Page.
Option #2 - Container settings
When deploying (via Docker or similar), you can set settings via environment variables or a mounted file to define default settings for all users. These will be applied everywhere, wherever the user is accessing the app from.
Note
These customizations only affect the default values. Users can still customize their personal preferences through the settings menu, and those will be stored in their browser's localStorage.
Disabling Settings
Once you've configured Networking Toolbox to your preferense, you can optionally disable the UI settings menu and functionality, to prevent users from editing site branding, colors or other settings. This can be done by setting NTB_DISABLE_SETTINGS='true' in your environmental variables.
Applying in Docker
To get started, take a look at our sample .env.
- With Docker run, include:
--env-file .env - And with docker-compose, just add:
env_file: [ .env ] - Or with any other NPM command:
env $(.env | xargs) npm start
An example extract from a docker-compose.yml:
environment:
- NTB_HOMEPAGE_LAYOUT=categories
- NTB_NAVBAR_DISPLAY=default
- NTB_DEFAULT_THEME=dark
- NTB_FONT_SCALE=2
Available Environment Variables
Branding
-
NTB_SITE_TITLE- Description: The name/title of your site
- Default:
Networking Toolbox - Example:
NTB_SITE_TITLE='My Network Tools'
-
NTB_SITE_DESCRIPTION- Description: Site description shown in navbar and SEO meta tags
- Default:
Your companion for all-things networking - Example:
NTB_SITE_DESCRIPTION='Internal network utilities'
-
NTB_SITE_ICON- Description: Logo/icon to display in the navbar (path to image or URL)
- Default: Empty (uses default icon)
- Example:
NTB_SITE_ICON='/custom-logo.svg'orNTB_SITE_ICON='https://example.com/logo.png'
Layout & Display
-
NTB_HOMEPAGE_LAYOUT- Description: Default homepage layout style
- Options:
categories,default,minimal,carousel,bookmarks,small-icons,list,search,empty - Default:
categories - Example:
NTB_HOMEPAGE_LAYOUT='minimal'
-
NTB_NAVBAR_DISPLAY- Description: Default navbar display mode
- Options:
default,bookmarked,frequent,none - Default:
default - Example:
NTB_NAVBAR_DISPLAY='bookmarked'
Theme & Appearance
-
NTB_DEFAULT_THEME- Description: Default color theme
- Options:
dark,light,midnight,arctic,ocean,purple,cyberpunk,terminal,lightpurple,muteddark,solarized,nord,gruvbox,tokyonight,catppuccin,everforest,sunset,dracula - Default:
ocean - Example:
NTB_DEFAULT_THEME='dark'
-
NTB_PRIMARY_COLOR- Description: Primary color for the interface (hex code)
- Default: Empty (uses theme default)
- Example:
NTB_PRIMARY_COLOR='#ff6b35'
-
NTB_FONT_SCALE- Description: Default font size level
- Options:
0(Very Small),1(Small),2(Normal),3(Large),4(Very Large) - Default:
2 - Example:
NTB_FONT_SCALE='3'
Localization
NTB_DEFAULT_LANGUAGE- Description: Default language for the interface
- Options:
en,es,fr,de(currently onlyenis fully supported) - Default:
en - Example:
NTB_DEFAULT_LANGUAGE='en'
Features
-
NTB_SHOW_TIPS_ON_HOMEPAGE- Description: Show helpful tips on the homepage
- Options:
true,false - Default:
false - Example:
NTB_SHOW_TIPS_ON_HOMEPAGE='true'
-
NTB_DISABLE_SETTINGS- Description: Disable the settings page and hide the settings button in the navbar
- Options:
true,false - Default:
false - Example:
NTB_DISABLE_SETTINGS='true' - Note: When enabled, users cannot access or modify any settings. The settings page shows "Settings for this instance have been disabled by your administrator."
Security Settings
Important
These settings protect against SSRF (Server-Side Request Forgery) attacks when using custom DNS servers in diagnostic tools.
-
NTB_ALLOW_CUSTOM_DNS- Description: Allow users to specify custom DNS server IPs
- Options:
true,false - Default:
false(for security) - Example:
NTB_ALLOW_CUSTOM_DNS='true' - Security Note: When
false, only servers fromNTB_ALLOWED_DNS_SERVERScan be used
-
NTB_BLOCK_PRIVATE_DNS_IPS- Description: Block private/internal IP addresses for DNS servers
- Options:
true,false - Default:
true(for security) - Example:
NTB_BLOCK_PRIVATE_DNS_IPS='true' - Security Note: Prevents SSRF attacks by blocking RFC1918 and other private IP ranges
-
NTB_ALLOWED_DNS_SERVERS- Description: Comma-separated list of allowed DNS server IPs
- Default: Comprehensive list of trusted public DNS providers (Google, Cloudflare, Quad9, OpenDNS, etc.)
- Example:
NTB_ALLOWED_DNS_SERVERS='8.8.8.8,1.1.1.1,9.9.9.9' - Note: Only used when
NTB_ALLOW_CUSTOM_DNS='false'
Analytics Settings
-
NTB_ANALYTICS_DOMAIN- Description: Domain for analytics tracking (for Plausible or similar)
- Default:
networking-toolbox.as93.net - Example:
NTB_ANALYTICS_DOMAIN='myapp.example.com' - Disable: Set to
falseto disable analytics:NTB_ANALYTICS_DOMAIN='false'
-
NTB_ANALYTICS_DSN- Description: URL to the analytics script
- Default:
https://no-track.as93.net/js/script.js - Example:
NTB_ANALYTICS_DSN='https://plausible.io/js/script.js' - Disable: Set to
falseto disable analytics:NTB_ANALYTICS_DSN='false' - Note: Analytics is disabled if either
NTB_ANALYTICS_DOMAINorNTB_ANALYTICS_DSNis set tofalse
Example Configurations
Minimal Production Setup
NTB_SITE_TITLE='Corporate Network Tools'
NTB_SITE_DESCRIPTION='Internal IT utilities'
NTB_DEFAULT_THEME='dark'
NTB_HOMEPAGE_LAYOUT='categories'
High Security Configuration
NTB_ALLOW_CUSTOM_DNS='false'
NTB_BLOCK_PRIVATE_DNS_IPS='true'
NTB_ALLOWED_DNS_SERVERS='8.8.8.8,1.1.1.1'
NTB_ANALYTICS_DOMAIN='false'
NTB_ANALYTICS_DSN='false'
Full Customization
NTB_SITE_TITLE='DevOps Toolkit'
NTB_SITE_DESCRIPTION='Network diagnostic utilities'
NTB_SITE_ICON='/custom-logo.svg'
NTB_HOMEPAGE_LAYOUT='minimal'
NTB_NAVBAR_DISPLAY='bookmarked'
NTB_DEFAULT_THEME='cyberpunk'
NTB_PRIMARY_COLOR='#00ff88'
NTB_FONT_SCALE='2'
NTB_DEFAULT_LANGUAGE='en'
NTB_SHOW_TIPS_ON_HOMEPAGE='true'
NTB_ALLOW_CUSTOM_DNS='true'
NTB_BLOCK_PRIVATE_DNS_IPS='true'
NTB_ANALYTICS_DOMAIN='myapp.example.com'
NTB_ANALYTICS_DSN='https://plausible.io/js/script.js'
Self-Hosted (No Analytics)
NTB_SITE_TITLE='Internal Network Tools'
NTB_DEFAULT_THEME='dark'
NTB_ANALYTICS_DOMAIN='false'
NTB_ANALYTICS_DSN='false'