id: linkding
name: linkding
version: "1.0"
description: Minimal, fast self-hosted bookmark manager.
icon: https://serverkit.ai/imgs/template-icons/linkding.svg
website: https://linkding.link
documentation: https://linkding.link/installation/
categories:
  - productivity
  - bookmarks

variables:
  - name: HTTP_PORT
    description: Port for the linkding web UI (auto-assigned)
    type: port
    default: "9090"
    hidden: true
  - name: ADMIN_USERNAME
    description: Default admin username
    type: string
    default: "admin"
  - name: ADMIN_PASSWORD
    description: Default admin password (auto-generated)
    type: password
    length: 24

ports:
  - port: "${HTTP_PORT}"
    protocol: http
    description: linkding Web UI

requirements:
  memory: 256MB
  storage: 1GB

compose:
  services:
    linkding:
      image: sissbruecker/linkding:latest
      container_name: ${APP_NAME}
      restart: unless-stopped
      ports:
        - "${HTTP_PORT}:9090"
      environment:
        LD_SUPERUSER_NAME: "${ADMIN_USERNAME}"
        LD_SUPERUSER_PASSWORD: "${ADMIN_PASSWORD}"
      volumes:
        - linkding-data:/etc/linkding/data
      healthcheck:
        test: ["CMD-SHELL", "curl -fsS http://127.0.0.1:9090/health || exit 1"]
        interval: 30s
        timeout: 10s
        retries: 5
        start_period: 20s

  volumes:
    linkding-data:

post_install: |
  linkding is installed and running!

  - Web UI: http://your-server:${HTTP_PORT}
  - Username: ${ADMIN_USERNAME}
  - Password: ${ADMIN_PASSWORD}

  Sign in with the credentials above, then add the browser bookmarklet or
  extension to start saving bookmarks.