Foxel
Menu
OPEN SOURCE · SELF-HOSTED · AI-POWERED

Your files.Beyond storage.

Bring your scattered files into your own cloud. Find inspiration with AI semantic search. One place. Endless possibilities. All yours.

Your data, your controlMIT licensedFor individuals & teams
Foxel UI screenshot
Find the file on your mind, in your own wordsLive demo
Explore Foxel
01 / FEATURES

Less friction. More possibility.

From storage to search, file management feels simple again.

01

Unified file management

Manage files across different storage backends in one place, reducing context switching.

02

Pluggable storage backends

An extensible adapter model to integrate multiple storage types and expand on demand.

03

Semantic search

Search images, documents, and other unstructured content with natural language.

04

Built-in file preview

Preview images, videos, PDFs, Office docs, text, and code without downloading.

05

Permissions & sharing

Create public or private share links with clear access boundaries.

06

Background task center

Run async jobs (indexing, backups, etc.) without blocking the main app.

OPEN BY DESIGN.View source
02 / PLAYGROUND

Live demo.

Visit the demo environment to quickly understand key flows and UI interactions.

demo.foxel.cc
Username/Password: admin / admin
Note: the demo is for preview only; data may be reset at any time.
Use cases
Personal documents and photo archiving
Team sharing and permission management
Unified search across storage backends
Find content with semantic descriptions
03 / GET STARTED

Quickstart (Docker Compose)

Docker Compose is the recommended way to start Foxel.

  1. 01

    Create data directories

  2. 02

    Download the Compose file

    Consider updating SECRET_KEY and TEMP_LINK_SECRET_KEY in compose.yaml with random strong keys.

  3. 03

    Start services

  4. 04

    Open the app

    On first launch, follow the setup to initialize the admin account.

Terminal
# 01 Create data directories
mkdir -p data/db
mkdir -p data/mount
chmod 777 data/db data/mount

# 02 Download the Compose file
curl -L -O https://github.com/DrizzleTime/Foxel/raw/main/compose.yaml

# 03 Start services
docker-compose up -d

SELF-HOSTED. ALL YOURS.

Contributing & docs

Bugs, suggestions, and PRs are welcome. Contribution guide:

CONTRIBUTING_zh.md
04 / TOGETHER

Community

Join the community for updates, discussions, and support.

Telegram group

Scan the QR code to join:Telegram group QR code

WeChat group

drizzle2001
Scan the QR code to join:WeChat group QR code

If the QR code expires, add WeChat ID drizzle2001 and we’ll invite you to the group.

F YOUR FILES. YOUR WORLD.