explaingit

ca-x/nowledge-mem-snap

Analysis updated 2026-05-18

6GoAudience · ops devopsComplexity · 3/5Setup · moderate

TLDR

A self-hosted backup and restore service for Nowledge Mem: schedules automatic backups to S3, WebDAV, GCS, or SFTP with encrypted packages, retention policies, and a guided restore wizard.

Mindmap

mindmap
  root((nowledge-mem-snap))
    What It Does
      Backup Nowledge Mem
      Restore from backup
      Encrypt packages
    Storage Targets
      S3 and R2
      WebDAV
      Google Cloud Storage
      SFTP
    Scheduling
      Daily and weekly
      One-time auto-disable
      Manual CLI trigger
    Auth and Deploy
      Password login
      OIDC single sign-on
      Docker Compose
      SQLite or PostgreSQL
Click or tap to explore — scroll the page freely

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

Schedule daily automated backups of a self-hosted Nowledge Mem instance to an S3-compatible bucket with configurable retention policies.

USE CASE 2

Use the restore wizard to recover a Nowledge Mem instance from a backup stored on WebDAV, GCS, or SFTP after a server failure.

USE CASE 3

Enable per-task encryption for backup packages so remote storage providers cannot read backup contents.

USE CASE 4

Run a one-time CLI backup before upgrading Nowledge Mem using the go run . backup <tenant> <task> command.

What is it built with?

GoDockerSQLitePostgreSQLMySQLS3WebDAV

How does it compare?

ca-x/nowledge-mem-snapbeastmastergrinder/turbopuffer-engine-opensourcegnana997/periscope
Stars666
LanguageGoGoGo
Setup difficultymoderatemoderatemoderate
Complexity3/55/54/5
Audienceops devopsdeveloperops devops

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Docker Compose, a Nowledge Mem API key, and credentials for an S3, WebDAV, GCS, or SFTP storage target.

No license information is stated in the repository.

In plain English

Nowledge Mem Snap is a self-hosted backup and restore service for Nowledge Mem, a personal knowledge and note-taking application. If you run your own Nowledge Mem instance, this tool lets you schedule automatic backups to cloud storage providers (S3-compatible services, WebDAV, Google Cloud Storage, or SFTP) and restore from those backups when needed. The tool runs as a Docker container with a web interface. Each user gets an isolated workspace where they can configure storage targets (where backups go), backup sources (the Nowledge Mem API or mounted Docker volumes), retention policies (keep the latest N backups, keep backups from the last N days, or keep and delete before a specific date), and schedules (daily, weekly, or one-time). One-time tasks disable themselves automatically after they run. Backups can also be triggered manually from the UI or a CLI command. A step-by-step restore wizard guides you through scanning a remote storage location, picking the backup to restore, choosing import options, and watching live progress. Backup packages can be optionally encrypted at the task level, the password is entered only when starting a restore and is never stored. Authentication supports password login, an optional OIDC provider for single sign-on, and a first-run setup wizard. The app can be hosted at a URL subpath behind a reverse proxy. Database options include the default SQLite, or PostgreSQL or MySQL for larger deployments. This is for people who self-host Nowledge Mem and want automated, scheduled backups to their own cloud storage rather than relying on the application's default data location.

Copy-paste prompts

Prompt 1
Walk me through setting up Nowledge Mem Snap with Docker Compose to back up my Nowledge Mem instance to Cloudflare R2. What environment variables do I need in example.env?
Prompt 2
I want to enable OIDC login for Nowledge Mem Snap so my team can sign in with our identity provider. What NMEM_SNAP_OIDC_* variables do I need and how do I set the redirect URL?
Prompt 3
Set up a retention policy in Nowledge Mem Snap to keep only the latest 7 backups and automatically delete older ones from S3.
Prompt 4
My Nowledge Mem instance crashed. Walk me through using the Nowledge Mem Snap restore wizard to recover from an encrypted backup on my WebDAV storage.
Prompt 5
I want to host Nowledge Mem Snap behind a reverse proxy at the path /snap. What NMEM_SNAP_BASE_PATH setting and proxy config do I need?

Frequently asked questions

What is nowledge-mem-snap?

A self-hosted backup and restore service for Nowledge Mem: schedules automatic backups to S3, WebDAV, GCS, or SFTP with encrypted packages, retention policies, and a guided restore wizard.

What language is nowledge-mem-snap written in?

Mainly Go. The stack also includes Go, Docker, SQLite.

What license does nowledge-mem-snap use?

No license information is stated in the repository.

How hard is nowledge-mem-snap to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is nowledge-mem-snap for?

Mainly ops devops.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub ca-x on gitmyhub

Verify against the repo before relying on details.