A portable Python file server with resumable uploads and downloads, reachable from any web browser and over WebDAV, SFTP, FTP, TFTP and SMB.
AlistGo/alist
A self-hosted file list program that puts many cloud storage services and local disks behind one web interface and WebDAV.
Open-source alternative to:Google Drive
OneDrive
- Stars
- 50,352
- Forks
- 7,914
- Open issues
- 558
- Last commit
- 4 days ago
What is it?
AList is a file listing server written in Go, built on the Gin web framework with a SolidJS frontend. It connects to many storage backends, including local disks, OneDrive/SharePoint, Google Drive, S3, FTP/SFTP, SMB, Dropbox, and a long list of Chinese cloud drives, and presents their contents as one browsable directory tree.
Users can browse, preview, upload, rename, move, and copy files through the web interface, and can expose any mounted storage over WebDAV. Previews cover PDF, Markdown, code, images, video and audio with subtitles or lyrics, and Office documents. Access can be protected by passwords and authentication, and the project provides Docker images and Cloudflare Workers proxy support for deployment.
The program works by calling each provider's official SDK or API and redirecting downloads, rather than storing user data itself. It is licensed under AGPL-3.0.
Key features
- 01Connects to dozens of storage backends, including local disks, S3, SMB, and many cloud drives.
- 02Provides WebDAV access to mounted storages.
- 03Previews PDF, Markdown, code, media, and Office documents in the browser.
- 04Supports web upload, delete, rename, move, and copy operations.
- 05Offers password protection and authentication for routes.
- 06Can be deployed via Docker or Cloudflare Workers proxy.
Use cases
- Unifying files scattered across several personal cloud drives into one browsable index.
- Exposing a home or office NAS or cloud storage over WebDAV to other clients.
- Sharing a folder with others through a password-protected web page that allows uploads.
- Previewing media and documents from cloud storage without downloading them first.
Things to know
- Licensed under AGPL-3.0, a copyleft license that requires derivative works to be released under the same terms.
- The README warns that using storage services through their official APIs can lead to account bans or download speed limits.
In collections
Topics
FAQ
- What is alist?
- A self-hosted file list program that puts many cloud storage services and local disks behind one web interface and WebDAV. AList is a file listing server written in Go, built on the Gin web framework with a SolidJS frontend. It connects to many storage backends, including local disks, OneDrive/SharePoint, Google Drive, S3, FTP/SFTP, SMB, Dropbox, and a long list of Chinese cloud drives, and presents their contents as one browsable directory tree.
- Is alist free to use? What license does it have?
- alist is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
- Is alist still maintained?
- Actively maintained. The last commit to alist was on Oct 21, 2026.
- What can I use alist for?
- Unifying files scattered across several personal cloud drives into one browsable index. Exposing a home or office NAS or cloud storage over WebDAV to other clients. Sharing a folder with others through a password-protected web page that allows uploads. Previewing media and documents from cloud storage without downloading them first.
- Where can I get alist?
- The source code and installation instructions are on GitHub: https://github.com/AlistGo/alist
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
Self-hosted file transfer server supporting SFTP, FTP/S, HTTP/S and WebDAV over local, S3, Google Cloud Storage and Azure Blob storage.
A self-hosted file listing and management server that unifies many cloud storage providers and local storage behind one web interface and WebDAV.
A fast, lightweight self-hosted cloud for files, calendars, contacts and office editing, built in Rust with WebDAV, CalDAV and CardDAV support.
Self-hosted cloud storage server where files and notes are encrypted in the browser before they reach the server.
A Go tool that mounts multiple cloud drives and S3/WebDAV-style storage as one local folder, with rclone-compatible end-to-end encryption.