Skip to main content


Andy HsuGuideAdvancedGuideAbout 6 min


how to use

Follow the steps below to enable search:

  1. Go to the indexes page to select a Search index and click Save.
  2. After the index is saved, click Build indexes to build the index.
  3. Now you can search for files by click the search block on the top right corner of the page or by using the shortcut Ctrl + K.

❗❗❗ If you do not follow the above prompts, the prompt will be opened: Search Not available

Difference between different search indexes

  • database: Search by database, which is using the existing data.db. It will create a new table, record the parent directory, name, and size of every object, but the search does not split words which means that match whether the keywords you enter appear in the name of object. In general, if you don't have a specific search requirement, we recommend you choose it.
  • database (non-full-text search): The full-text search mode is used above, but full-text search will have some strange problems when using MySQL database as an Alist database, which has not been resolved yet, so if your Alist database Change to MySQL, and your Alist version ≥3.9.1 It is recommended that you use this to build an index, although it is slower than full-text search and the gap is not very big, but it will not search for strange files , it’s more secure. After the future version is repaired, we will inform you to use the new full-text search to build the index. If you are using sqlite3, you can use whichever you like.
  • bleve: An open source full-text search engine. It will split the words in the name of object and search for the keywords you enter. But its search results may be so strange that you can't get the results you want, and it will take up more resources.
  • sqlite3 is easy to trigger database is locked lock library cannot write files
    • Solution to database is locked:

      • It's because the database is building the index. If you are still in the building process, please wait patiently.
      • If the index has been completed, it is caused by turning on Automatically update the index. Please turn off Automatically update the index. If the problem still occurs, please close and restart AList.
      • Or switch the database to MySQL
  • meilisearch: I haven’t experienced it in depth yet and I don’t know much about the specific differences. It’s for professionals to use or you can check it yourself. View PR linkopen in new window , the only thing I know is that you have to build it yourselfopen in new window to use it. It supports many methods, but there is no daemon and other lazy operations, and it does not support the system It relies on Linux systems lower than GLIBC_2.27open in new window If it is built on this machine, it will be automatically recognized. If it is another device, you can modify the meilisearch field content of the configuration file.

The following table could help you understand the difference between the two search indexes quickly:

database(full text search)Database (non-full-text search)blevemeilisearch
Search resultsCan't find it in ChineseMore accurate than full-text search, you can search ChineseFuzzy match
Search speedFast,see above for advantages and disadvantagesSlower than full-text search, see above for advantages and disadvantagesFast
Specify folder searchYesYesNo
Disk usageLowLowHigh
Auto incremental updateYesYesNo


If you are using MySQL as the database, it is recommended to use non-full-text search (strongly recommended)

Non-full-text search Although it is not as fast as full-text search, it is not much slower. If you insist on using full-text search, you may have to sacrifice the inability to search Chinese

If you use sqlite as the database, there is no full-text search, you can choose any database~

Full-text search: It will not search in the text of all files, don't get it wrong.

Search tips

  • If you want to search for a specific folder, you must choose database as the search index;
  • If you choose database as the search index and the type of your database is sqlite3, we suggest that you don't make any changes in the admin page while building the index, as sqlite3 does not support concurrent writes and can cause database-lock issues;
  • If you choose bleve as the search index, and if you want to search for new files or if you don't want to search for deleted files, the index needs to be completely rebuilt to take effect because bleve does not support incremental updates;
  • But for database, it supports incremental updates, so you can search for new files or deleted files just by access the modified folder (and click refresh icon if cached) without rebuilding the index, which is much more convenient than bleve.

Ignore paths

Paths to be skipped during index building, one path per line, multiple lines can be filled

  • example:
    • /aaa network disk

    • /bbb network disk/ccc folder

Update index

  • (formerly: the path to update the index)

After building all the indexes, or a file has a large number of file updates, but it is inconvenient to rebuild, you can use this to update the index

  • example:

    • /aaa network disk

    • /bbb network disk/ccc folder

Automatically update the index

⚠️ The default is off, and the index will not be built automatically

For example, you have already built the index, but added a network disk mount or folder update later

But you have already built a lot of indexes. According to the previous words, there are two methods

  1. Go in folder by folder before building
  2. Or it is cumbersome to refactor all

But this time, just turn on the Automatically build index button and enter the Newly mounted network disk or Updated folder, the indexed files in this directory and The folder automatically builds the index without entering a folder by folder to let him build it automatically

  • Advantages: Don't worry, all the indexes in this folder can be automatically built if there is an update into the root directory of the updated folder
  • Cons: always on call ready to build

Someone will find out that [Path to update index](#Path to update index) can also be updated? Can be updated but the two do not conflict

  • Automatically update index: suitable for users who build indexes for all files
  • Update Index: Suitable for not to build indexes for all files, but there are files that need to be built, manually build indexes to avoid all being indexed

Maximum index depth

default 20.

The one shown outside is built manually, and the update index option selects the depth in the update index button.

Explanation: The directory can enter up to several layers. For example, if you have a folder with a depth of 30 layers, set it to 20, and only build the first 20 layers, and the remaining 10 layers will not be built.

⚠️ Precautions for use

The database file is very large, what should I do if it is still the same after clearing the index?

Normal users do not modify the database options. They use the sqlite database to build indexes, which will cause the database file to be particularly large

  • -Data files, Data folders in the same directory in Alist program,data.db,data.db-shm,data.db-wal

After turning on the constructive index, the more the number you build, the larger the files. Finally, you accidentally occupy the machine's hard disk, and then click the clear index button. What should I do if the file is still as big?

  • This is caused by the cache of sqlite, there are two solutions

    1. We use commands or tools to connect to sqlite database, input:VACUUM;
    1. After using the command to clean up, we replace it with mysql database before constructing indexes

Comparison after cleaning the command: The picture above shows before cleaning up, and the following figure shows that after cleaning, you can execute several commands several times if there is no effect.

data.db, data.db-shm, data.db-wal when backup, when backup,data.db-shm,data.db-walDo these two files need backup?

  • In the backup, stop the program first, and then backup. You only need to backup the data.db database file. The other two do not need to backup
  • It may be after you stop the programdata.db-shm,data.db-walwill automatically disappear, don't worry