mrkeyoor.com_
Fri 04 Sept 06:44 UTC
Self-Hostedevaluationupdated 04 Sept 2026

project-nomad review

Project N.O.M.A.D. turns a Debian computer into an offline knowledge server with Wikipedia, courses, maps, notes, data tools, and optional local AI. A browser-based command center installs and manages the separate services, which is much easier than assembling the same collection of containers by hand.

Verdict

Our Project N.O.M.A.D. test command failed after 19 seconds because the repository defines no real npm tests, even though the 10-second install step completed cleanly with 0 known vulnerabilities. Use it if one x86-64 Debian box must keep reference material, courses, maps, and optional AI available without an internet connection. Walk away if you need built-in accounts, official ARM support, or evidence from a working root-level test command before trusting updates.

We ran it

Lab card: what happened when we ran project-nomadScreenshot of project-nomad (www.projectnomad.us)
Install✓ · 10s0 packages · 27 MB
Buildn/ano build script
Tests✗ · 19sran, no count parsed
Known vulns00 critical · 0 high · 0 moderate · 0 low (npm audit)
Repo519 files~69,192 lines of source · 17.4 MB · 6 CI workflows · Dockerfile

Answers from our run

Does project-nomad build from source?

Dependencies installed in 10 seconds (0 packages), and the project has no separate build step. We cloned commit f8e40fb into a clean Debian container with 3 CPUs and no project-specific setup.

Do project-nomad's tests pass?

The test command failed in our container, and its output did not report a pass or fail count.

Does project-nomad have known vulnerabilities in its dependencies?

npm audit found none in the dependency tree at the time of our run.

Who should not use project-nomad?

Anyone who needs user accounts or safe direct internet exposure: the README says Project N.O.M.A.D. has no authentication and recommends network-level controls.

What are the alternatives to project-nomad?

Internet-in-a-Box, Kiwix Tools, Umbrel. Our Project N.

Setup3/5One installer helps, but root, Docker, storage, and networking remain
Docs4/5Clear install, hardware, privacy, update, and platform guidance
Community5/536,491 stars with current releases and active issue traffic
Maturity3/5Active v1.34.1 project, but no root npm tests or authentication

Who it’s for

Families, schools, field teams, and preparedness users who need useful reference material when the internet is unavailable.
Self-hosters with an x86-64 Debian or Ubuntu box who want Kiwix, Kolibri, maps, and local AI under one interface.
Technically confident owners willing to manage Docker, storage, backups, and network access on their own hardware.

Who it’s NOT for

Anyone who needs user accounts or safe direct internet exposure: the README says Project N.O.M.A.D. has no authentication and recommends network-level controls.
Raspberry Pi and other ARM owners seeking official support: the FAQ says the project targets x86-64 and publishes no official ARM images.
macOS or non-Debian Linux users who expect maintainer support: those platforms are not officially supported, while the Windows WSL2 route is community-supported.
Buyers expecting full local AI and a large offline library on minimal hardware: the README moves from a 5 GB core minimum to 250 GB of preferred storage for the fuller AI setup.

Setup reality

Our sandbox install step succeeded in 10 seconds, added 0 npm packages, and used 27 MB on disk. There was no build script, so we skipped that step. The test command failed after 19 seconds because it only printed Error: no test specified and exited with code 1. Npm audit reported 0 known vulnerabilities.

The actual product setup is a different, privileged path. Its quick installer needs root access, a Debian-based x86-64 host, internet access for the initial downloads, and Docker. The command center then runs MySQL, Redis, and the content services you select. Local AI can use Ollama, or you can configure a remote Ollama or OpenAI-compatible endpoint.

The management app listens on port 8080 by default and has no login screen. Storage paths and core-service ports can be changed through Docker Compose, but the FAQ says installed applications do not all share that port flexibility. A bare setup starts at 4 GB of RAM and 5 GB of storage; the README suggests 32 GB of RAM, a capable GPU, and 250 GB of storage for the fuller AI experience.

Eight built-in capabilities replace separate admin screens

Across 519 files, Project N.O.M.A.D. groups 8 capabilities in one command center: offline reference material, education, maps, data tools, notes, hardware scoring, an app catalog, and optional AI. It manages Kiwix, Kolibri, ProtoMaps, CyberChef, FlatNotes, Ollama, and Qdrant. N.O.M.A.D. is the common doorway, while those containers do the specialist work.

Several of those services belong naturally on the same machine. Our checkout had about 69,192 lines of source, yet users get a browser interface for choosing content and managing downloads. A household can keep encyclopedias and maps beside school courses. A field office can offer the same local library to several devices. Someone who wants only Wikipedia should run Kiwix directly and avoid the extra control plane.

A 2 GHz host can start small, while local AI asks for much more

The documented floor is a 2 GHz dual-core processor, 4 GB of RAM, and 5 GB of free storage. That covers the management layer, not every catalog item. Installation needs internet access to fetch software and content, after which selected resources can work offline. An offline library still has to be acquired and updated somewhere.

The README suggests 32 GB of RAM, an RTX 3060 or comparable GPU, and at least 250 GB of storage for the fuller AI setup. Ollama runs locally by default, with Qdrant supporting document search. A remote Ollama or OpenAI-compatible server can be configured, but the owner must make it reachable. AI is optional, so a school library can avoid that hardware cost.

What happened when we ran it

Our sandbox install step finished in 10 seconds, added 0 packages, and occupied 27 MB. The repository had no build script or target, so the build was skipped. Npm audit found 0 known vulnerabilities: 0 critical, 0 high, 0 moderate, and 0 low. These figures describe commit f8e40fb in our unprivileged Node 22 container with 3 CPUs and 8 GB of RAM.

The test step failed after 19 seconds. The package script printed Error: no test specified and returned exit code 1. The log does not show an application defect or a missing Debian package. It shows that the root npm command is a placeholder. Our measurement method did not run the privileged installer or launch Docker services, so this result is not a complete appliance trial.

Version 1.34.1 still needs a private network boundary

Project N.O.M.A.D. v1.34.1 has no built-in authentication. The README says the server is meant to be open without hurdles, recommends network-level access controls, and warns against direct internet exposure. That works for a disconnected machine in one room. It is a serious limitation on a shared office LAN, school network, or host reachable through careless router rules.

The command center uses Docker outside of Docker, giving its container access to the host socket so it can manage sibling services. Core components include MySQL and Redis, and the browser address uses port 8080 by default. Owners should treat this as an appliance with authority over containers. Firewall rules, backups, host patching, and physical access remain their responsibility.

Official support stops at Debian-based x86-64 hosts

The supported route is Debian-based Linux on x86-64, with Ubuntu 26.04 LTS recommended and Ubuntu 24.04 LTS plus Debian 12 also listed. The installer needs sudo or root. Windows has a community-supported WSL2 guide, while macOS and other Linux families are outside official support. Raspberry Pi users get no official ARM image or maintainer-backed installation path.

Advanced installation uses Docker Compose and exposes storage mounts and core-service ports for editing. The FAQ says installed apps do not all support the same port customization. External or network storage is possible, though the owner must prepare mounts and pass them through correctly. That matters when a collection grows toward the README's preferred 250 GB. A failed mount can be worse than an awkward first install because the library is the asset.

September 2026 activity is high, and the test entry point trails it

GitHub recorded 36,491 stars, 89 combined issues and pull requests, and a last push on September 4, 2026. Release v1.34.1 arrived on September 2 with 2 Kiwix catalog fixes. Recent activity includes download reports, model-download state handling, and dependency updates. The combined count is not a defect count, but the dated traffic and release work show that maintainers and users are present.

The placeholder test command is harder to excuse at that pace. Our 19-second failure gives a contributor no root-level confirmation for commit f8e40fb, despite 6 CI workflow files elsewhere in the repository. An operator can trial the appliance on an isolated machine, verify each selected service, and keep updates opt-in. Teams with formal release gates should inspect workflow coverage and define a restore test before storing a large offline library.

Internet-in-a-Box is the better choice for supported ARM hardware

Our 17.4 MB checkout led to a platform suited to one x86-64 machine with offline content and an approachable container catalog. Internet-in-a-Box better fits education deployments that want a supported Raspberry Pi route. Kiwix Tools removes most of the platform when ZIM archives are enough. Umbrel has a broader home-server catalog, but focuses on general self-hosting rather than information for an outage.

The 17.4 MB checkout is small, while a useful deployment can span databases, content stores, and optional model services. Choose N.O.M.A.D. for a deliberately isolated appliance whose owner controls the hardware and network. Its friendly browser screen does not supply authentication, backup design, or update verification.

Alternatives

ProjectWhat it isPick it when
Internet-in-a-BoxAn offline education and library server with broad content support, including Raspberry Pi hardware.pick this instead when educational content and supported Raspberry Pi deployment matter more than N.O.M.A.D.'s command center and local AI bundle.
Kiwix ToolsCommand-line tools for serving and managing ZIM archives without a larger home-server layer.pick this instead when offline Wikipedia and other ZIM files are the whole job and you want fewer moving parts.
UmbrelA home-server operating system with a large app catalog and a polished browser interface.pick this instead when a general home app server matters more than an offline-first knowledge collection.

What people are saying

  1. [velocity-scout] Crosstalk-Solutions/project-nomad

Sources

  1. Project N.O.M.A.D. repository
  2. Project N.O.M.A.D. README
  3. Project N.O.M.A.D. FAQ
  4. Project N.O.M.A.D. v1.34.1 release
  5. Project N.O.M.A.D. issues and pull requests

More self-hosted reviews

consul · gpt-load · limusic · xbmc · owncast · crowdsec · the whole board →