selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
Alist-Sync logo

Self-host Alist-Sync

v1.1.5

Web-based Alist storage sync with multi-task scheduling

ReleaseOpen SourceMulanPSL-2.0
Updatedlast year
LanguagePython
Setup difficultyEasy
Stars
173
Port
52441 (Web UI)
Docker
xjxjin/alist-sync
Install with Docker Compose
Data sync mode interface showing storage driver selection and directory configurationFile sync mode interface with source and destination path pairsFile move mode interfaceAlist token retrieval guideTask progress viewing interface

What is Alist-Sync?

Alist-Sync is a self-hosted web tool for synchronizing data across Alist storage providers. It provides a browser-based dashboard to create and manage sync tasks in three modes: data sync (directory-level between storage drivers), file sync (explicit path pairs), and file move (copy then delete source). Tasks can be run manually or on cron schedules, with options to keep, move to trash, or delete extra files in the destination. The app stores its configuration and logs in JSON files on a mounted volume, requires no external database, and authenticates users with a built-in username/password system (default admin/admin). It is distributed as a Docker image (xjxjin/alist-sync) and deployed via docker-compose on port 52441. The project is actively maintained with recent releases and supports Qinglong panel integration for scheduled runs.

Should you self-host Alist-Sync?

Alist-Sync scores 43/100 on selfhost.directory (how scoring works) and ranks #10 of 15 in File Sync. It has 173 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is MulanPSL-2.0-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is Syncthing (90/100, 89 828 stars). It scores higher overall, so compare the two before you pick. See Alist-Sync vs Syncthing side by side.

Features

  • Built-in user authentication
  • Configuration import/export
  • Cron scheduled tasks
  • Data sync mode
  • Detailed sync logs
  • Differential handling strategies
  • File move mode
  • File sync mode
  • Multi-task management
  • Qinglong panel integration
  • Regex pattern filtering
  • Token validation
  • Web-based management UI

Alist-Sync README

How to install Alist-Sync

Install Alist-Sync with Docker Compose

version: '3'

services: alist-sync-web: image: xjxjin/alist-sync:latest container_name: alist-sync restart: unless-stopped ports: - "52441:52441" volumes: - /DATA/AppData/alist-sync/data:/app/data environment: - TZ=Asia/Shanghai

Create data directory first: mkdir -p /DATA/AppData/alist-sync-web/data

How to configure Alist-Sync

  • BASE_URLServer base URL (without trailing slash) for Qinglong integration

    Server base URL (without trailing slash) for Qinglong integration

  • CRON_SCHEDULECron schedule expression for Qinglong integration

    Cron schedule expression for Qinglong integration

  • DIR_PAIRSSource and target directory pairs (semicolon-separated, colon-delimited) for Qinglong integration

    Source and target directory pairs (semicolon-separated, colon-delimited) for Qinglong integration

  • EXCLUDE_DIRSDirectories to exclude from sync for Qinglong integration

    Directories to exclude from sync for Qinglong integration

  • MOVE_FILEWhether to move files (delete source) for Qinglong integration

    Whether to move files (delete source) for Qinglong integration

  • PASSWORDPassword for Qinglong integration

    Password for Qinglong integration

  • REGEX_PATTERNSRegex patterns for filename matching in Qinglong integration

    Regex patterns for filename matching in Qinglong integration

  • SYNC_DELETE_ACTIONAction for extra files in destination: move to trash or delete

    Action for extra files in destination: move to trash or delete

    values: move, delete

  • TOKENAlist API token for Qinglong integration

    Alist API token for Qinglong integration

  • TZAsia/ShanghaiTimezone for the container

    Timezone for the container

    values: Any valid TZ identifier

  • USERNAMEUsername for Qinglong integration

    Username for Qinglong integration

Alist-Sync releases & version history

More in File Sync

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…