---
title: SnapOtter
emoji: 🦦
colorFrom: indigo
colorTo: purple
sdk: docker
app_port: 7860
pinned: false
license: agpl-3.0
fullWidth: true
short_description: Self-hosted file toolkit — 200+ convert/OCR/PDF tools
---

# SnapOtter on a Hugging Face Docker Space (CPU)

[SnapOtter](https://docs.snapotter.com/) is an open-source, self-hosted file-processing
toolkit: 200+ image / video / audio / PDF / document tools (convert, compress, crop, merge,
split, OCR, transcribe, convert-presets) behind a web UI, a REST API and pipelines.

This Space runs the **official upstream image** (`snapotter/snapotter:latest`, linux/amd64)
in **embedded mode** — no external Postgres/Redis — on free CPU Basic hardware
(2 vCPU / 16 GB RAM / 50 GB disk). It is deployed for the `psychoguineapig.com` box, which
retired its local SnapOtter container on 2026-10-14 to reclaim ~8.6 GB of disk and ~200 MiB
of RAM; running it here costs the host nothing.

## What works and what does not

- ✅ All 222 non-AI tools: image resize/crop/convert/compress/watermark, video trim/mute/remux,
  audio convert/normalize/trim, PDF merge/split/compress/rotate/protect, file conversions.
- ⚠️ AI bundles (background removal, upscale, face enhance, transcription) need `/dev/shm`
  and are slow on 2 vCPU; the platform does not let a Space set `shm_size`, so expect some
  AI tools to fail or crawl. Install bundles from **Settings → AI Features** at your own risk.
- ⚠️ **This Space is ephemeral.** HF Spaces have no persistent volume any more, so the
  embedded database, users and the file library all reset whenever the container is
  rebuilt or restarted. Treat it as a scratch tool, not storage.
- ⚠️ Free CPU Basic Spaces sleep after ~48 h idle; the next visit wakes the Space
  (cold start ≈ 1–2 min, including the 8 GB image boot).

## Ports

`app_port: 7860` and `ENV PORT=7860` — both sides pinned to the platform's convention.

## Auth

`AUTH_ENABLED` defaults to `true` with a first-run admin account (`DEFAULT_USERNAME` /
`DEFAULT_PASSWORD` supplied as Space **secrets**, never in this repo), and
`SKIP_MUST_CHANGE_PASSWORD` is not set by us — the operator changes it on first login.
The instance sits behind a Cloudflare Access wall at `snapotter.psychoguineapig.com` as well,
so the app login is defence in depth rather than the only gate on the public Hub URL.