mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
126 lines
4.2 KiB
Markdown
126 lines
4.2 KiB
Markdown
---
|
|
description: Install SnapOtter with Docker in one command. Includes Docker Compose setup, building from source, and a full feature overview.
|
|
---
|
|
|
|
# Getting Started
|
|
|
|
::: tip Try before installing
|
|
Explore the full UI at [demo.snapotter.com](https://demo.snapotter.com) -- no signup or install required.
|
|
:::
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
docker run -d --name SnapOtter -p 1349:1349 -v SnapOtter-data:/data snapotter/snapotter:latest
|
|
```
|
|
|
|
You will be asked to change your password on first login.
|
|
|
|
::: tip NVIDIA GPU acceleration
|
|
Add `--gpus all` for GPU-accelerated background removal, upscaling, OCR, face enhancement, and restoration:
|
|
|
|
```bash
|
|
docker run -d --name SnapOtter -p 1349:1349 --gpus all -v SnapOtter-data:/data snapotter/snapotter:latest
|
|
```
|
|
|
|
Requires the [NVIDIA Container Toolkit](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html). Falls back to CPU automatically. See [Docker Tags](/guide/docker-tags) for benchmarks.
|
|
:::
|
|
|
|
::: details Also on GHCR
|
|
```bash
|
|
docker run -d --name SnapOtter -p 1349:1349 -v SnapOtter-data:/data ghcr.io/snapotter-hq/snapotter:latest
|
|
```
|
|
|
|
Both registries publish the same image on every release.
|
|
:::
|
|
|
|
## Docker Compose
|
|
|
|
```yaml
|
|
services:
|
|
SnapOtter:
|
|
image: snapotter/snapotter:latest # or ghcr.io/snapotter-hq/snapotter:latest
|
|
ports:
|
|
- "1349:1349"
|
|
volumes:
|
|
- SnapOtter-data:/data
|
|
environment:
|
|
- AUTH_ENABLED=true
|
|
- DEFAULT_USERNAME=admin
|
|
- DEFAULT_PASSWORD=admin
|
|
restart: unless-stopped
|
|
|
|
volumes:
|
|
SnapOtter-data:
|
|
```
|
|
|
|
See [Configuration](/guide/configuration) for all environment variables.
|
|
|
|
## Build from Source
|
|
|
|
**Prerequisites:** Node.js 22+, pnpm 9+, Python 3.10+ (for AI features), Git.
|
|
|
|
```bash
|
|
git clone https://github.com/snapotter-hq/SnapOtter.git
|
|
cd SnapOtter
|
|
pnpm install
|
|
pnpm dev
|
|
```
|
|
|
|
- Frontend: [http://localhost:1349](http://localhost:1349)
|
|
- Backend: [http://localhost:13490](http://localhost:13490)
|
|
|
|
## What You Can Do
|
|
|
|
### Image Processing (53 Tools)
|
|
|
|
| Category | Tools |
|
|
|----------|-------|
|
|
| **Essentials** | Resize, Crop, Rotate & Flip, Convert, Compress |
|
|
| **Optimization** | Optimize for Web, Strip Metadata, Edit Metadata, Bulk Rename, Image to PDF, Favicon Generator |
|
|
| **Adjustments** | Adjust Colors, Sharpening, Replace Color, Color Blindness Simulation |
|
|
| **AI Tools** | Remove Background, Upscale, Erase Object, OCR, Blur Faces, Smart Crop, Image Enhancement, Enhance Faces, Colorize, Noise Removal, Red Eye Removal, Restore Photo, Passport Photo, Content-Aware Resize, AI Canvas Expand, PNG Transparency Fixer |
|
|
| **Watermark & Overlay** | Text Watermark, Image Watermark, Text Overlay, Image Composition, Meme Generator |
|
|
| **Utilities** | Image Info, Compare, Find Duplicates, Color Palette, QR Code Generator, Barcode Reader, Image to Base64, HTML to Image |
|
|
| **Layout** | Collage, Stitch, Split, Border & Frame, Beautify |
|
|
| **Format** | SVG to Raster, Vectorize, GIF Tools, PDF to Image |
|
|
|
|
### Pipelines
|
|
|
|
Chain tools into multi-step workflows and apply them to one image or a whole batch:
|
|
|
|
1. Open **Pipelines** in the sidebar.
|
|
2. Add steps (any tool, any settings).
|
|
3. Run on a single file - or an entire batch at once.
|
|
4. Save the pipeline for later reuse.
|
|
|
|
Pipelines have unlimited steps by default.
|
|
|
|
### File Library
|
|
|
|
Every file you process can be saved to your **Files** library. SnapOtter tracks the full version history so you can trace every processing step from the original upload to the final output.
|
|
|
|
### REST API & API Keys
|
|
|
|
Every tool is accessible via HTTP:
|
|
|
|
```bash
|
|
curl -X POST http://localhost:1349/api/v1/tools/resize \
|
|
-H "Authorization: Bearer si_<your-api-key>" \
|
|
-F "file=@photo.jpg" \
|
|
-F 'settings={"width":800,"height":600,"fit":"cover"}'
|
|
```
|
|
|
|
Generate API keys under **Settings → API Keys**. See the [REST API reference](/api/rest) for all endpoints, or visit [http://localhost:1349/api/docs](http://localhost:1349/api/docs) for the interactive reference.
|
|
|
|
### Multi-User & Teams
|
|
|
|
Enable multiple users with role-based access control:
|
|
|
|
- **Admin**: full access - manage users, teams, settings, all files/pipelines/API keys
|
|
- **User**: use tools, manage own files/pipelines/API keys
|
|
|
|
Create teams under **Settings → Teams** to group users.
|
|
|
|
Set `AUTH_ENABLED=true` (or `false` for single-user/self-use without login).
|