this post was submitted on 20 Feb 2026
34 points (81.5% liked)

Selfhosted

61632 readers
369 users here now

A place to share alternatives to popular online services that can be self-hosted without giving up privacy or locking you into a service you don't control.

Rules:

Detailed Rules Post

  1. Be civil.

  2. No spam.

  3. Posts are to be related to self-hosting.

  4. Don't duplicate the full text of your blog or readme if you're providing a link.

  5. Submission headline should match the article title.

  6. No trolling.

  7. Promotion posts require active participation, with an account that is at least 30 days old. F/LOSS without a paywall has exceptions, with requirements. See the rules link for details. Tags [CBH] or [AIP] are required, see the links in Rule 8 for details.

  8. AI-related discussions and AI-involved promotional posts have additional requirements for tagging, as noted in Rule 7 and the AI & Promotional Post Expanded Rules post, and find example disclosures here.

Resources:

Any issues on the community? Report it using the report flag.

Questions? DM the mods!

founded 3 years ago
MODERATORS
 

Interesting tool based on blocks to tag any document for photos you own. With app to allow access from any device. Blocks contains tags and links between them to organize all like a heap.
I haven't installed the self-hosted version yet to see how it can interact with an existing Obsidian vault. Next step.
Site: https://heaper.de/

you are viewing a single comment's thread
view the rest of the comments
[–] ClownStatue@piefed.social 6 points 6 months ago* (last edited 6 months ago) (1 children)

Some notes:

  • This can be self-hosted. My working compose.yml is below
  • Free until August, and he has a discord for feedback, but I can't find the invite. It was in the live-stream he did.
  • He said in the stream that he's open to open sourcing the project. Just not there yet.
  • He admits the licensing is a little confusing. He stressed that self-hosting does not have a storage or block limit. Also, self-hosting is possible with all licenses (I think).
  • Supports macOS, Linux, Windows, iOS, and Android (in beta I think)

My compose file:

services:  
  heaper-postgres:  
    image: ghcr.io/janlunge/heaper-postgres:latest  
    container_name: heaper-postgres  
    environment:  
      POSTGRES_USER: $POSTGRES_USER  
      POSTGRES_PASSWORD: $POSTGRES_PASSWORD  
      POSTGRES_DB: $POSTGRES_DB  
    ports:  
      - "5432:5432"  
    volumes:  
      - /path/to/heaper/postgres:/var/lib/postgresql/data  
    networks:  
      - heaper  
    healthcheck:  
      test: ["CMD-SHELL", "pg_isready -U heaper -d heaper || exit 1"]  
      interval: 10s  
      timeout: 5s  
      retries: 5  
      start_period: 20s  

  heaper:  
    image: ghcr.io/janlunge/heaper:latest  
    container_name: heaper  
    platform: linux/amd64  
    environment:  
      HOSTNAME: heaper.caruthers.us  
      ENABLE_INTERNAL_POSTGRES: "false"  
      DB_HOST: heaper-postgres:5432  
      DB_USER: $POSTGRES_USER  
      DB_PASS: $POSTGRES_PASSWORD  
      DB_NAME: $POSTGRES_DB  
    ports:  
      - "3000:443"  
      - "4499:80"  
    volumes:  
      - /path/to/heaper/config:/usr/src/app/config  
      - /path/to/heaper/thumbnails:/mnt/thumbnails  
      - /path/to/heaper/storage:/mnt/storage  
    networks:  
      - heaper  
    depends_on:  
      heaper-postgres:  
        condition: service_healthy  
    healthcheck:  
      # Docs show example health probes; adjust host/port if your container differs.  
      test: ["CMD-SHELL", "curl -fsS http://localhost/api >/dev/null || exit 1"]  
      interval: 15s  
      timeout: 5s  
      retries: 5  
      start_period: 30s  

networks:  
  heaper:  
    name: heaper  

I have the DB, config, and thumbnails on local NVME, and storage on NFS-mounted NAS. Working fine so far.

ETA: Correction in compose file.

[–] EncryptKeeper@lemmy.world 1 points 6 months ago (1 children)

Does it store uploaded files in plain text on the file system?

[–] ClownStatue@piefed.social 1 points 6 months ago

From what I can tell, notes are stored in the DB, but can be exported as JSON, or I think markdown. It sure about markdown. I’ve only been able to export JSON, and it didn’t include the image I had embedded in the note. Whatever isn’t a note (images, movies, pdf, doc, etc.) is stored on the file system in a directory structure that files them under heap -> asset checksum. Thumbnails are included there if applicable. In that regard, it kind of forces you to use its folder structure.