whatisgithub

What is ente-backups?

doorlay/ente-backups — explained in plain English

Analysis updated 2026-05-18

20GoAudience · developerComplexity · 3/5Setup · moderate

In one sentence

A self-hosted Docker tool that automatically backs up an Ente photo library locally and, optionally, encrypted to S3.

Mindmap

mindmap
  root((ente-backups))
    What it does
      Syncs Ente photo library
      Encrypted S3 backups
      Push notifications
    Setup
      Docker Compose
      Configure env file
      First Ente login
    Optional features
      Restic S3 backup
      ntfy.sh alerts
    Tech stack
      Go
      Docker
      restic
    Audience
      Self hosters

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run on a home server or Raspberry Pi to automatically sync an Ente photo library every hour.

USE CASE 2

Add encrypted, point-in-time backups of the photo library to an S3-compatible bucket via restic.

USE CASE 3

Get a push notification on a phone when a sync or backup succeeds or fails.

What is it built with?

GoDocker Composeresticntfy.sh

How does it compare?

doorlay/ente-backupsabolix/xplexdondai1234/agent-browser
Stars202020
LanguageGoGoGo
Setup difficultymoderatehardeasy
Complexity3/53/52/5
Audiencedeveloperops devopsdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Needs Docker Compose and enough local storage for a full photo library, the first sync can take hours.

So what is it?

ente-backups automates local and remote backups of a photo library stored in Ente, a photo storage service. It runs as a Docker Compose setup meant for a headless server that has enough free storage for a full photo library, such as a Raspberry Pi connected to an external drive. By default it syncs from Ente every hour using the Ente command line tool, and once a day it can also push an encrypted backup of everything to an S3 storage bucket using a tool called restic, though both the schedule and the S3 step can be adjusted. Setting it up starts with copying an example environment file and filling in Ente account details, then building and starting the Docker container. The first time it runs, a person logs into their Ente account from inside the container and points it at an export directory, which needs to match the path configured in the environment file. The first full sync can take hours for a large library, but it can run in the background without needing to stay connected to the terminal. The S3 backup step through restic is optional. If someone wants it, they create an S3 bucket, an access key with permission to read and write to it, and fill those details into the environment file before initializing the restic repository. Leaving those settings empty simply skips the daily backup step rather than causing an error. There is also an optional notification feature using a free service called ntfy.sh, which can send a push notification to a phone or desktop when a sync or backup succeeds or fails. To avoid too many notifications, successful syncs are batched into one daily summary rather than sent every hour, while failures and restic backup results are sent immediately. This feature is also optional and simply stays off if no topic name is configured.

Copy-paste prompts

Prompt 1
Walk me through setting up ente-backups with Docker Compose on a headless server.
Prompt 2
Help me configure the restic S3 backup section of the .env file for this project.
Prompt 3
Explain what happens during the first sync and why it can take hours.
Prompt 4
Set up ntfy.sh notifications so I get alerted when a backup fails.

Frequently asked questions

What is ente-backups?

A self-hosted Docker tool that automatically backs up an Ente photo library locally and, optionally, encrypted to S3.

What language is ente-backups written in?

Mainly Go. The stack also includes Go, Docker Compose, restic.

How hard is ente-backups to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is ente-backups for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.