SnapOtter - A Self-Hosted File Manipulation Suite

Docker Hub GHCR CI OpenSSF Best Practices License Stars Website Live Demo Discord Sponsor

Open-source, self-hosted file-processing infrastructure. Convert, compress, OCR, transcribe, strip metadata, and run local AI across image, video, audio, PDF, and documents, through a UI, REST API, and pipelines. Your files never leave your network.

The one self-hosted stack that replaces CloudConvert, Smallpdf, TinyPNG, TinyWow, and Otter.ai. 200+ tools across five modalities, on hardware you own.

![SnapOtter - Dashboard](branding/dashboard.gif) Stirling-PDF stops at PDFs. ConvertX stops at conversions. SnapOtter runs all five, and your files never leave your server. Edit images, convert video, transcribe audio, repair PDFs, batch your files: one Docker stack, on hardware you own. ## Quick Start One command, that's it. ```bash docker run -d --name SnapOtter -p 1349:1349 -v SnapOtter-data:/data snapotter/snapotter:latest ``` Open [http://localhost:1349](http://localhost:1349) and log in with `admin` / `admin`. That's the whole install. For the production Compose stack, NVIDIA GPU acceleration, and configuration, see [Deployment](#deployment) below. ## Key Features - **200+ tools across 5 modalities:** - **Image (107):** resize, crop, compress, convert, watermark, color adjust, beautify screenshots, generate memes, vectorize, GIF tools, find duplicates, passport photos, plus dedicated format converters (JPG to PNG, HEIC to JPG, WebP to PNG, image to PDF, and more). Supports 55+ input formats (including 23 camera RAW formats) and 17 output formats - **Video (57):** convert, compress, trim, resize, crop, merge, video-to-GIF, extract audio, stabilize, change FPS, burn/extract subtitles, plus dedicated converters (MOV to MP4, MKV to MP4, MP4 to MP3, and more) - **Audio (27):** convert, trim, normalize, volume, fade, pitch shift, silence removal, noise reduction, merge/split, waveform, plus dedicated converters (M4A to MP3, AAC to MP3, OGG to WAV, and more) - **PDF (29):** merge, split, compress, convert, protect/unlock, redact, sign, watermark, page numbers, OCR, plus PDF to JPG/PNG/TIFF - **Files (23):** CSV/JSON/XML/YAML conversion, CSV merge/split, Excel to CSV, chart maker, ZIP create/extract - **Image editor:** Free layer-based editor with brushes, shapes, adjustments, filters, curves, and keyboard shortcuts. Runs in your browser and processes on your hardware - **Local AI:** Remove backgrounds, upscale images, restore and colorize old photos, erase objects, blur faces, enhance faces, extract text (OCR from images and PDFs), transcribe audio, auto-generate video subtitles, expand canvas, and fix transparency. All on your hardware, no internet required. Built-in Fast OCR adds about 25 MiB to the official image; the optional accuracy pack installs on demand - **OIDC / SSO:** Login with Google, GitHub, Okta, or any OpenID Connect provider - **21 languages:** English, Arabic, Chinese (Simplified & Traditional), Dutch, French, German, Hindi, Indonesian, Italian, Japanese, Korean, Polish, Portuguese, Russian, Spanish, Swedish, Thai, Turkish, Ukrainian, Vietnamese. RTL support for Arabic - **Pipelines:** Chain tools into reusable workflows, 20 steps by default (`MAX_PIPELINE_STEPS`). Import/export as JSON. Batch size is unlimited in the published image and 100 from a source build (`MAX_BATCH_SIZE`) - **REST API:** Every tool available via API with API key auth. Interactive docs at `/api/docs` - **Self-hosted:** one `docker run` for a single-container quick start (embedded Postgres 17 + Redis 8), or the same Postgres 17 + Redis 8 as a Compose stack for production. No external SaaS dependencies - **Multi-arch:** Runs on AMD64 and ARM64 (Intel, Apple Silicon, Raspberry Pi) - **Privacy first:** Your files never leave your network. Basic analytics help us catch bugs and improve tools. Disable them at build time with `SNAPOTTER_ANALYTICS=off` or at runtime with the in-app admin opt-out ([Here's how to do it](https://docs.snapotter.com/guide/deployment.html#analytics)) ## Deployment The [Quick Start](#quick-start) one-liner above is all most people need. For production, run the 3-container Compose stack (app + Postgres 17 + Redis 8). Save this as `compose.yaml`: ```yaml services: snapotter: image: snapotter/snapotter:latest ports: ["1349:1349"] environment: DATABASE_URL: postgres://snapotter:snapotter@postgres:5432/snapotter REDIS_URL: redis://redis:6379 volumes: - SnapOtter-data:/data depends_on: [postgres, redis] restart: unless-stopped postgres: image: postgres:17-alpine environment: POSTGRES_USER: snapotter # Change this for any non-local deployment. POSTGRES_PASSWORD: snapotter POSTGRES_DB: snapotter volumes: ["SnapOtter-pgdata:/var/lib/postgresql/data"] restart: unless-stopped redis: image: redis:8-alpine volumes: ["SnapOtter-redisdata:/data"] restart: unless-stopped volumes: SnapOtter-data: SnapOtter-pgdata: SnapOtter-redisdata: ``` Then start the stack: ```bash docker compose up -d ```
Have an NVIDIA GPU? Click here for CUDA acceleration.
Use the GPU Compose file for NVIDIA CUDA-accelerated background removal, upscaling, and transcription. OCR deliberately uses the same portable CPU runtime on CPU-only and NVIDIA hosts. Intel/AMD iGPU acceleration through VA-API, Quick Sync, or OpenCL is not supported for AI inference today; those systems run AI tools on CPU. See [Docker Tags](https://docs.snapotter.com/guide/docker-tags) for the GPU Compose example and benchmarks.
**Default credentials:** | Field | Value | |----------|---------| | Username | `admin` | | Password | `admin` | You will be asked to change your password on first login. For Docker Compose, persistent storage, and other setup options, see the [Getting Started Guide](https://docs.snapotter.com/guide/getting-started). For NVIDIA CUDA acceleration and tag details, see [Docker Tags](https://docs.snapotter.com/guide/docker-tags). ## Documentation - [Getting Started](https://docs.snapotter.com/guide/getting-started) - [Upgrading from 1.x to 2.0](https://docs.snapotter.com/guide/upgrading) - [Configuration](https://docs.snapotter.com/guide/configuration) - [OIDC / SSO](https://docs.snapotter.com/guide/oidc) - [Deployment](https://docs.snapotter.com/guide/deployment) - [Supported Formats](https://docs.snapotter.com/guide/supported-formats) - [Docker Tags](https://docs.snapotter.com/guide/docker-tags) - [REST API](https://docs.snapotter.com/api/rest) - [AI Engine](https://docs.snapotter.com/api/ai) - [Image Engine](https://docs.snapotter.com/api/image-engine) - [Architecture](https://docs.snapotter.com/guide/architecture) - [Database](https://docs.snapotter.com/guide/database) - [Developer Guide](https://docs.snapotter.com/guide/developer) - [Contributing](https://docs.snapotter.com/guide/contributing) - [Translation Guide](https://docs.snapotter.com/guide/translations) ## Contributing We welcome bug reports, feature ideas, and pull requests. See [CONTRIBUTING.md](CONTRIBUTING.md) for the full guide, or jump in: - [Open an issue](https://github.com/snapotter-hq/snapotter/issues) - [Submit a PR](CONTRIBUTING.md#code-requires-cla) - [Join Discord](https://discord.gg/hr3s7HPUsr) for help and discussion - [Sponsor the project](https://github.com/sponsors/snapotter-hq) to keep SnapOtter free for everyone ## Support SnapOtter SnapOtter is built and maintained independently with no venture capital or corporate backing. Sponsorships fund infrastructure, keep releases flowing, and ensure the project stays free and open for everyone. If SnapOtter has replaced a paid subscription or two in your workflow, a small sponsorship helps keep it that way: Sponsor SnapOtter on GitHub

SnapOtter star history chart

## License This project is dual-licensed under the [AGPLv3](LICENSE) and a commercial license. - **AGPLv3 (free):** You may use, modify, and distribute this software under the AGPLv3. If you run a modified version as a network service, you must make your source code available under the AGPLv3. - **Commercial license (paid):** For use in proprietary software or SaaS products where AGPLv3 source-disclosure is not suitable, a commercial license is available. [Contact us](mailto:contact@snapotter.com) for pricing and terms. See [LICENSING.md](LICENSING.md) for full details on the open-core boundary between AGPLv3 and commercial code.