{
  "id": 19257966,
  "title": "Project NOMAD Storage Moves: Keep These Three Paths Identical",
  "url": "https://urgent.news/2026/11/10/project-nomad-storage-moves-keep-these-three-paths-identical",
  "topic": "tech",
  "section": "Tech",
  "published": "2026-11-10T01:15:53.000Z",
  "source": {
    "name": "Dev.to",
    "slug": "dev-to",
    "url": "https://dev.to/9904099/project-nomad-storage-moves-keep-these-three-paths-identical-3hnk"
  },
  "original_language": "en",
  "account": "Project NOMAD is an offline-first knowledge and education server designed to store and provide access to various materials. The deployment process involves connecting to a supported host, running an installation script, and manually using a management_compose.yaml template. For a manual installation, the installation directory should be placed in /opt/project-nomad. Important variables such as APP_KEY, URL, DB_PASSWORD, MYSQL_PASSWORD, and MYSQL_ROOT_PASSWORD must be set during the installation process. It's crucial to ensure that the three storage references in the Compose template match exactly, including letter case. Changing only one storage reference can result in an empty library after the move. To perform a successful migration, stop the stack, move the original storage directory to its new location, update the admin and disk-collector bind mounts, and then start the stack again. Verify the content and disk usage in the interface to confirm the move was successful. If external or network storage is used, it must be mounted on the host first. Supported targets include Docker, NAS, and Raspberry Pi, but NAS graphical stack imports and Raspberry Pi/ARM were not officially tested or supplied with official images at the time of the guide.",
  "summary": "This is a third-party deployment note, not official Project NOMAD or Crosstalk Solutions documentation. It focuses on manual Compose installation and a storage-migration pitfall that can make an existing content library appear empty. Project NOMAD is an offline-first knowledge and education server for material such as Wikipedia, books, courses, and maps. Installation and content downloads need…",
  "key_points": [
    "Project NOMAD stores knowledge and education materials offline.",
    "Ensure exact match of three storage references in Compose template.",
    "Stop stack, move storage directory, update bind mounts to migrate."
  ],
  "editors_take": "Strict adherence to directory naming conventions during migration prevents data loss by ensuring the knowledge server correctly maps its internal storage references to the new host location.",
  "illustration": null,
  "coverage": {
    "outlets": 1,
    "also_reported_by": []
  },
  "ai_generated": true,
  "disclaimer": "Summaries, key points and the editor’s take are written by software from other outlets’ reporting and may contain errors — always check the linked original."
}