Full configuration export/import system for Homarr with excellent DX:
- Export/import boards, apps, integrations (with re-encrypted secrets),
users (with bcrypt hashes), groups (with permissions and memberships),
search engines, and server settings
- Homepage services.yaml import with widget-type mapping
- Generic resolveEntities() utility eliminates per-entity boilerplate
- Declarative entity-fields.ts: adding a new user preference requires
only one line change (no export/import/schema edits needed)
- User schema uses .catchall(z.unknown()) for forward-compatible prefs
- groupByKey() utility replaces manual Map-building
- CONFIG_ENTITY_KEYS as single source of truth for entity metadata
- Reuse existing entities (apps by name+icon+href, integrations by
kind+name+url, users by email, groups by name, boards by name)
- Skip duplicates with warnings rather than failing
- Onboarding flow skips user creation step when config includes users
- Reuse existing admin group during onboarding after config import
Add a dedicated Import/Export tool page with full configuration export/import
(v2.0 bundle with encrypted secrets), Homepage services.yaml import with env
variable resolution, and manual Docker label discovery (moved from cron job).
Support importing Homarr JSON during onboarding alongside legacy zip import.
New @homarr/board-portability package handles schema, serialization, compat
checks, and import planning. Shared preview UI reused across admin and onboarding.
Fix xterm.js crash by removing deprecated @xterm/addon-canvas (incompatible
with xterm v6). Fix Homepage env variable i18n and React 19 currentTarget bug.
See docs/config-portability.md for full changelog.
* feat: add default search engines seeding
* feat: set Homarr Docs as the default search
Set the default search engine in server settings during seeding
* refactor: use typed methods to define settings
* feat: add insertServerSettingByKeyAsync
* feat: update seeding logic for server settings
* fix: format file using prettier
* fix: disable eslint for `urlTemplate`
* refactor: remove never happning else
* feat: enhance createDocumentationLink
- Updated createDocumentationLink to accept query parameters
* test: add unit tests for createDocumentationLink
* fix: update urlTemplate for Homarr documentation
* feat(board): add mobile home board
* fix: add missing translations
* fix: mysql key reference with other datatype
* fix: format issue
* fix: missing trpc context arguments in tests
* fix: missing trpc context arguments in tests
* feat: add server settings for default board, default color scheme and default locale
* chore: address pull request feedback
* test: adjust unit tests to match requirements
* fix: deepsource issue
* chore: add deepsource as dependency to translation library
* refactor: restructure language-combobox, adjust default locale for next-intl
* chore: change cookie keys prefix from homarr- to homarr.
* feat: add media management
* feat: add missing page search item
* fix: medias should be hidden for anonymous users
* chore: rename show-all to include-from-all-users
* fix: inconsistent table column for creator-id of media
* fix: schema check not working because of custom type for blob in mysql
* chore: temporarily remove migrations
* chore: readd removed migrations
* feat: add everyone group through seed
* feat: add reserved group name check in group router actions
* feat: improve user interface for everyone group
* fix: reserved group alert is a server component
* feat: add all users to everyone group
* chore: update lockfile
* fix: format issues
* fix: lint issues
* fix: lint format issues
* test: add unit tests for everyone group
* refactor: add codegen for documentation urls by sitemap
* refactor: change group query to count
* chore: remove migrations temporarily
* chore: add migrations again
* chore: add lint rule to prevent usage of raw documentation links
* fix: format issues
* feat: add first day of week user setting
* fix: add missing migrations
* fix: format and test issues
* fix: deepsource issue
* refactor: rename first-day-of-week procedure