explaingit

alistgo/alist

Analysis updated 2026-06-20

49,434GoAudience · ops devopsComplexity · 3/5LicenseSetup · easy

TLDR

Self-hosted web app that connects Google Drive, OneDrive, Dropbox, S3, and dozens more cloud storage services into one browseable file interface with preview, sharing, and WebDAV access.

Mindmap

mindmap
  root((repo))
    What it does
      Unified file browser
      Preview files online
      Share via links
      WebDAV network drive
    Supported storage
      Google Drive OneDrive
      Dropbox S3
      Local folders
    Tech Stack
      Go Gin backend
      SolidJS frontend
      Docker
    Who uses it
      Self-hosters
      Power users
      Ops teams
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Browse all your cloud storage accounts, Google Drive, OneDrive, Dropbox, in one unified web interface without switching apps.

USE CASE 2

Share files from any connected storage via a permanent public link without downloading them first.

USE CASE 3

Mount all your cloud storage as a single network drive using WebDAV from your operating system or any WebDAV-compatible app.

USE CASE 4

Copy files between two different cloud providers directly on the server without downloading them to your machine.

What is it built with?

GoGinSolidJSDockerWebDAV

How does it compare?

alistgo/alisthashicorp/terraformjesseduffield/lazydocker
Stars49,43448,33750,931
LanguageGoGoGo
Setup difficultyeasymoderateeasy
Complexity3/54/51/5
Audienceops devopsops devopsops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Docker deployment is straightforward, connecting cloud storage providers requires OAuth app credentials for each service.

AGPL-3.0, free to use and modify, but if you run a modified version as a public service you must release your source changes as open source.

In plain English

AList is a self-hosted file listing and access program that lets you connect dozens of different cloud storage services into a single unified web interface. The problem it solves is fragmentation: you might have files spread across Google Drive, OneDrive, Dropbox, an S3-compatible storage bucket, a local folder on your server, and several Chinese cloud storage platforms, and normally managing all of them means switching between different apps and websites. AList connects all of them and presents a single browseable file tree accessible through your browser. Once deployed, the web interface allows you to preview many file types directly in the browser, including PDFs, images, videos, audio files with lyrics and subtitle support, and Office documents. Files can be downloaded directly or shared via permanent links. The server also exposes a WebDAV interface, which is a standard protocol that lets you mount the combined storage as a network drive in your operating system or use it with third-party apps that support WebDAV. You can also configure password protection, allow visitors to upload files, and copy files between two connected storage providers without downloading them to your machine first. You would use AList if you need a centralized way to browse and share files that are scattered across multiple cloud storage accounts, or if you want a simple self-hosted web interface for files on your own server. It is aimed at people comfortable running a small server application. Deployment is straightforward with Docker. The tech stack is Go for the backend using the Gin web framework, and SolidJS for the front-end browser interface, all under the AGPL-3.0 open-source license.

Copy-paste prompts

Prompt 1
Write a Docker Compose file to deploy AList and configure it with an initial admin password and a local folder as a storage provider.
Prompt 2
Generate an AList configuration to add a Google Drive storage provider and set the folder to be publicly accessible via a share link.
Prompt 3
I want to mount my AList instance as a WebDAV drive on macOS. Give me the exact steps and the URL format I need to use in Finder.
Prompt 4
Write a step-by-step guide to set up AList on a VPS using Docker, including setting the admin password and adding an S3-compatible bucket as a storage provider.
Prompt 5
How do I configure AList to allow visitor file uploads to a specific folder while keeping the rest of the file tree read-only?

Frequently asked questions

What is alist?

Self-hosted web app that connects Google Drive, OneDrive, Dropbox, S3, and dozens more cloud storage services into one browseable file interface with preview, sharing, and WebDAV access.

What language is alist written in?

Mainly Go. The stack also includes Go, Gin, SolidJS.

What license does alist use?

AGPL-3.0, free to use and modify, but if you run a modified version as a public service you must release your source changes as open source.

How hard is alist to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is alist for?

Mainly ops devops.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub alistgo on gitmyhub

Verify against the repo before relying on details.