Skip to content
simmmmmPublic

About

Your household's photographs on your own NAS, as Numa sees them. One Docker container.

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

22 Commits

Folders and files

Repository files navigation

Numa Home

Your household's photographs, at home. Numa Home runs on your own NAS and shows every photograph in the house in a browser: on the sofa, on a phone, on the TV. Raws look the way Numa develops them, with your edits on them. Faces and words are found the way the Numa app finds them, on your NAS. Nothing goes to the cloud.

One container. No database server, no separate machine-learning container.

Numa Home in a browser: the photographs by month, a bar for a card in the NAS, the filters by who took them, and the scrubber with the years on the right

More on numa.photo/numa-home, and every page explained in the guide.

What it does

  • A timeline of everything. Every month in one scroll, with a scrubber on the right that shows where each trip is.
  • Raws, developed. RAF, ARW, CR3, NEF, DNG and the rest, rendered with Numa's colour and your edits. Not the camera's small preview.
  • People. Faces are found and grouped. Name them once and they are found everywhere.
  • Search in words. Type "beach at sunset", "reiger" or "Anna and Tom in the snow", in English or Dutch.
  • The whole household. An account for each person. Filter by who took a photograph. Albums, stars and picks are shared.
  • Send Home. The Numa apps send photographs home: from Linux and the Mac's export dialog as a JPEG or as the original with its edits, and from the iPhone the whole Photos library, quietly, on Wi-Fi and while charging. The same photograph sent twice is kept once.
  • Back into Numa. Bring a library from Home into Numa on your computer, edit it there, and it stays in step with Home both ways.
  • An SD card in the NAS. Put a card in and import from the browser, checked file by file. Each shoot goes to the trip it belongs to, or to a new folder you name.
  • Your archive as it is. Point it at the folders you already have. A library made by the Numa app keeps its stars, edits and names.
A search for flowers, finding fourteen photographs of tulips, sunflowers, daisies and other flowers One photograph large with Open in Numa, the info button and Download; beside it the name, date, stars, Pick and Reject, the camera, the size, By and the library
Tidy Up: counts for Exact Copies, Unusable and Who Took These, and a set of two copies with Numa's Pick marked, Keep Best and Keep All Numa Home on a phone: the photographs by month

Install

Numa Home is a Docker image for x86-64 and arm64: ghcr.io/simmmmm/numa-home. Docker picks the right one by itself.

arm64 is untested. It is built for ARM NAS models, Apple-silicon Macs and 64-bit Raspberry Pi boards, but nobody here has ARM hardware to try it on. If it does not start, or something is slow or wrong, please open an issue with your device and docker logs numa-home. If it works, an issue saying so helps too.

  1. Put compose.yaml in a folder and change the left side of each volume to where things live on your machine: /photos is the folder that holds your photographs, /sent and /data are folders of its own.

  2. Start it:

    docker compose up -d

    On a NAS with a Docker app (UGREEN, Synology, QNAP, Unraid, Portainer), create a project or stack and paste the same file.

  3. Set TZ to your time zone (for example Europe/Berlin): the night shift, when Numa Home catches up and checks everything, runs from 01:00 to 06:00 in it.

  4. Open http://<host>:8283 and make the first account. It can make one for everyone else.

On the first start the face and search models are downloaded (about 520 MB) into /data. The photographs are then read in the background, on at most half the processor. The Activity page shows how far it has got and can pause it.

Updating: pull the image again and restart. Accounts, names and everything already read stay in /data.

SD cards and USB drives

To import cards from the browser, add the folder where the host mounts removable drives as /cards, read only, with rslave propagation so a card put in later shows up:

      - type: bind
        source: /media
        target: /cards
        read_only: true
        bind:
          propagation: rslave

The Intel iGPU

Optional, for faster decoding: devices: ["/dev/dri:/dev/dri"].

Good to know

  • Port 8283 on your own network. To reach it from outside, use a reverse proxy or a VPN such as Tailscale. Numa Home does not expose itself.
  • One writer. Numa Home keeps a small catalog inside each library's .numa folder. Don't open those same folders over the network in the Numa app at the same time; use Send Home and Numa Home libraries instead. Two programs writing one database over SMB can damage it.
  • No video yet. Photographs only, for now.

Source and licence

Numa Home is part of Numa, a raw developer for Linux, the iPhone, the iPad and the Mac. Its source is there, under the GPL 3.0 or later. Each image is built from that repository's release tag of the same version. The models keep their own licences, listed in Numa's THIRD_PARTY_LICENSES.txt.

About

Your household's photographs on your own NAS, as Numa sees them. One Docker container.

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors