Installation

Choose your method

Binary

Download the latest release for your platform:

Platform	Architecture	Download
Linux	x86_64	rustyfile-linux-amd64
Linux	ARM64	rustyfile-linux-arm64

chmod +x rustyfile-linux-amd64
mv rustyfile-linux-amd64 /usr/local/bin/rustyfile

Note

Pre-built binaries are available for Linux only. For macOS, build from source.

Docker

docker run -d \
  --name rustyfile \
  -p 8080:80 \
  -v /your/files:/data \
  -v rustyfile-config:/config \
  rustyfile/rustyfile

Or with Docker Compose:

docker-compose.yml

services:
  rustyfile:
    image: rustyfile/rustyfile
    ports:
      - "8080:80"
    volumes:
      - /your/files:/data
      - rustyfile-config:/config
    restart: unless-stopped

volumes:
  rustyfile-config:

From Source

Prerequisites: Rust 1.80+, optionally Node 22+ and pnpm for the frontend.

1. Clone the repository

   git clone https://github.com/zaakirio/rustyfile.git
   cd rustyfile

2. Build the frontend (optional — embedded by default)

   cd frontend && pnpm install && pnpm build && cd ..

3. Build the binary

   cargo build --release

4. The binary is at target/release/rustyfile

Tip

The embed-frontend Cargo feature is enabled by default. It bakes the React frontend into the binary so you get a single self-contained file.

Requirements

• Runtime: None. The binary is fully self-contained (SQLite is bundled).
• Optional: FFmpeg + ffprobe on PATH for HLS video transcoding.
• Disk: Database and caches are stored in --data-dir (default: ./rustyfile-data).