안녕하세요. 달소입니다.

 

오랜만에 설치가이드네요.

요즘 너무 깜빡깜빡하기도하고,, 바쁜 일상에서 기억해야할것들을 북마크하기위해서 Hoarder를 구성해보려고합니다.

꽤 관심있게 지켜보던 프로젝트였는데 기능도 점점 좋아지는듯 해서 한번 직접 설치를 진행해보겠습니다.

 

Hoarder란?

 

데이터를 쌓아두는 사람들을 위해 AI가 적용된, 모든 것을 북마크할 수 있는 셀프호스팅 앱입니다.

 

 

특징

• 🔗 링크를 북마크하고, 간단한 메모를 작성하고, 이미지와 PDF를 저장하세요.
• ⬇️ 링크 제목, 설명, 이미지를 자동으로 가져옵니다.
• 📋 북마크를 목록으로 정렬하세요.
• 🔎 저장된 모든 콘텐츠의 전체 텍스트 검색.
• ✨ AI 기반(일명 chatgpt) 자동 태그. ollama!를 사용하여 로컬 모델을 지원합니다.
• 🎆 이미지에서 텍스트를 추출하는 OCR.
• 🔖 빠른 북마크를 위한 Chrome 플러그인 과 Firefox 애드온 . 
• 📱 iOS 앱 과 Android 앱 .
• 📰 RSS 피드를 통한 자동 저장.
• 🌐 REST API.
• 🗄️ 링크 부패로부터 보호하기 위해 전체 페이지 보관( monolith 사용 ). youtube-dl을 사용하여 자동 비디오 보관 .
• ☑️ 대량 작업 지원.
• 🔐 SSO 지원.
• 🌙 다크 모드 지원.
• 💾 먼저 셀프 호스팅을 하세요.
• [예정] 오프라인에서 읽을 수 있도록 콘텐츠를 다운로드합니다.

⚠️이 앱은 현재 개발 중이며 안정성이 매우 낮습니다.

 

구성환경

Ubuntu 24.04 LTS

Docker

Dockge

 

 

Hoarder 설치하기

설치는 dockge를 통해서 진행하겠습니다.

 

stack을 + 해주고 compose.yml 에는 아래 내용을 작성합니다.

version: "3.8"
services:
  web:
    image: ghcr.io/hoarder-app/hoarder:${HOARDER_VERSION:-release}
    restart: unless-stopped
    volumes:
      - data:/data
    ports:
      - 3000:3000
    env_file:
      - .env
    environment:
      MEILI_ADDR: http://meilisearch:7700
      BROWSER_WEB_URL: http://chrome:9222
      # OPENAI_API_KEY: ...
      DATA_DIR: /data
  chrome:
    image: gcr.io/zenika-hub/alpine-chrome:123
    restart: unless-stopped
    command:
      - --no-sandbox
      - --disable-gpu
      - --disable-dev-shm-usage
      - --remote-debugging-address=0.0.0.0
      - --remote-debugging-port=9222
      - --hide-scrollbars
  meilisearch:
    image: getmeili/meilisearch:v1.11.1
    restart: unless-stopped
    env_file:
      - .env
    environment:
      MEILI_NO_ANALYTICS: "true"
    volumes:
      - meilisearch:/meili_data

volumes:
  meilisearch:
  data:

 

그리고 .env에도 

 

아래 내용을 넣어주시는데 NEXTAUTH_SECRET 와 MEILI_MASTER_KEY는 서버에서 아래명령어로 나온 값을 넣어주세요.

Version의 경우 수동으로 버전을 지정해주거나 release로 해놓으면 안정버전으로 사용할 수 있습니다.

 

openssl rand -base64 36

 

HOARDER_VERSION=release
NEXTAUTH_SECRET=super_random_string
MEILI_MASTER_KEY=another_random_string
NEXTAUTH_URL=http://localhost:3000

 

최종적으로 아래처럼 스택을 구성하고 배포해주시면됩니다.

 

 

구성이 완료되면 ip:3000 포트로 접속해주시면됩니다.

 

Sign Up으로 처음 생성한 계정이 관리자 계정이됩니다.

 

 

로그인 후 기본기능들을 사용할 수 있습니다. 

 

 

링크만 붙여넣어도 알아서 파싱되고

 

 

tag나 Note도 달수있고 요약도 할수있습니다.

 

 

그리고 각 북마크별로 아카이브 설정이나 즐겨찾기 등등도 가능합니다.

 

 

User setting에서

AI 프롬프트나 RSS 구독설정, 기존 북마크 가져오기 등등 설정도 가능합니다.

 

 

 admin setting은 링크에 대해 다시 크롤링하거나 유저관리등의 기능도 제공됩니다.

 

크롬 확장프로그램 사용하기

 크롬 확장프로그램을 사용하면 북마크앱으로서의 200% 활용도 가능합니다.

 

 

 

 

이렇게 연결이되고나서 북마크 하고싶은 페이지에서 우클릭을누르면

 

Add to Hoarder 가 활성화됩니다.

 

 누르면 바로 Hoarder에 들어갑니다.

 

 

참 쉽죠? 앱도있기때문에 취향에 맞게 설치해서 활용하시면되겠습니다.