Source: https://cliparr.dev/docs/getting-started/

Documentation

# Getting started

Run Cliparr with Docker, keep settings persistent, and open the app for the first time.

Run Cliparr in Docker, then open the app and connect Plex, Jellyfin, or a local video. Mount `/data` before connecting media servers so settings and encrypted credentials survive updates.

Docker quick start

macOS / Linux

```bash
docker run -d \
  --name cliparr \
  -p 7171:7171 \
  -e APP_KEY="your-32-char-stable-random-secret" \
  -v cliparr-data:/data \
  ghcr.io/techsquidtv/cliparr:latest
```

PowerShell

```powershell
docker run -d `
  --name cliparr `
  -p 7171:7171 `
  -e APP_KEY="your-32-char-stable-random-secret" `
  -v cliparr-data:/data `
  ghcr.io/techsquidtv/cliparr:latest
```

On Windows, run this from Docker Desktop or another Docker engine using Linux containers. Cliparr publishes Linux container images for linux/amd64 and linux/arm64.

Open `http://localhost:7171`, connect Plex or Jellyfin, or choose **Open Video** for a local file.

Stable APP\_KEY required

Use a stable random `APP_KEY` at least 32 characters long. If it changes later, Cliparr cannot decrypt the stored provider credentials and you will need to reconnect sources.

Use HTTPS for editing

Cliparr uses browser WebCodecs in the editor. Use an HTTPS reverse proxy for remote access, or open the app through `localhost` or `127.0.0.1` while testing locally. See [Browser support](https://cliparr.dev/docs/browser-support) for the current feature support snapshot.

## Docker Compose

For a persistent setup, keep the same `APP_KEY` and volume across updates.

docker/compose.yml

```yaml
services:
  cliparr:
    image: ghcr.io/techsquidtv/cliparr:latest
    container_name: cliparr
    ports:
      - "7171:7171"
    environment:
      - APP_KEY=replace-this-with-a-32-character-secure-random-string
    volumes:
      - cliparr-data:/data
    restart: unless-stopped

volumes:
  cliparr-data:
```

## Next steps

When a playable source is available, Cliparr opens the timeline editor. The timeline spans the full video, and the block labeled with the media title represents the range to export. Drag the block to choose a different moment, or drag either edge to adjust `In` and `Out`.

Use the scrollbar to navigate and zoom into subtitle timing, then export the clip. See [Editor shortcuts](https://cliparr.dev/docs/editor-shortcuts) for precise timecodes, range editing, and long-video navigation.