logologo
HomeGallery
  • Why?
  • Docs
  • Demo
  • Download
    Start
    Install
    General
    docker-compose
    docker
    Binary
    App Bundle
    Generic Bundle
    Source
    Azure
    Configuration
    CLI
    help
    run
    export meta
    export static
    fetch
    database
    storage
    plugin
    cast
    Webapp
    Search
    FAQ
    API server
    Recipes
    Use Nginx proxy with subpath
    Use Traefik proxy with subpath
    Use IIS Proxy With a Sub-Path
    Internals
    Workflow
    Building Blocks
    Data Structures
    Design Decisions
    Development
    Plugin
    Extractor Plugin
    Database Mapper Plugin
    Query Plugin
    Previous pageBinaryNext pageGeneric Bundle

    #Application bundle

    HomeGallery can be also downloaded as tar.gz archive from dl.home-gallery.org/dist for Linux, Mac and Windows. These tar.gz archives are the same as the prebuilt binaries. You have to start the main script manually.

    These tar balls include binaries for the given platform

    • NodeJS
    • ffmpeg and ffprobe
    • sharp
    • exiftool
    Note

    On Linux and Mac perl needs to be installed and in the PATH environment variable.

    #Quickstart

    curl -sL https://dl.home-gallery.org/dist/latest/home-gallery-latest-linux-x64.tar.gz -o home-gallery.tar.gz
    tar xvf home-gallery.tar.gz
    cd home-gallery
    node gallery.js run init --source ~/Pictures
    node gallery.js run server &

    While your media files are imported open your HomeGallery at localhost:3000 in your browser.

    #Run the CLI

    The CLI with all commands of the app bundle is started via

    node gallery.js -h

    #Upgrade the gallery

    To upgrade the gallery software, please stop your current server, download the latest version and start the new version.

    Please run the import command to rebuild the database. This step will add new features and fix missing database entries. If all your media is already imported the import can be done in parallel with the server command.

    # stop the current server
    mv home-gallery home-gallery.old
    curl -sL https://dl.home-gallery.org/dist/latest/home-gallery-latest-linux-x64.tar.gz -o home-gallery.tar.gz
    tar xvf home-gallery.tar.gz
    cd home-gallery
    node gallery.js import
    node gallery.js run server &