Deploy OpenList

File list and WebDAV server for S3, cloud drives and local disk

Deploy OpenList

/opt/openlist/data

Deploy and Host OpenList on Railway

OpenList is an open-source file list and WebDAV server, the community fork of AList. It puts one web interface in front of many storage backends, such as S3, Google Drive, OneDrive, Dropbox, WebDAV, FTP, SMB and local disk, so you can browse, preview, share and download files from all of them in one place.

About Hosting OpenList

This template runs the official OpenList image, version 4.2.9, pinned by digest and built from a public GitHub repo, as one service with a Railway volume at /opt/openlist/data. That volume holds the SQLite database, config.json with the JWT secret, the search index and logs, so users, storages and settings survive redeploys. The admin user is created on first start with a generated password (OPENLIST_ADMIN_PASSWORD), so the public setup wizard is never exposed. There are no prompts. After deploy, sign in as admin with that password, change it, and add your storages under Manage → Storages. A health check on /ping guards each deploy, and updates arrive as Railway update notices.

Common Use Cases

  • One web file browser and download portal for several cloud drives and S3 buckets
  • A WebDAV endpoint (/dav) that mounts cloud storage in desktop and mobile clients
  • Sharing files and folders from your own storage with password-protected share links

Dependencies for OpenList Hosting

  • A Railway volume for OpenList's data folder (included)
  • Credentials for the storage backends you want to add (added in the web UI after deploy)

Deployment Dependencies

Implementation Details

  • Sign in at https://YOUR-DOMAIN as admin. The password is the OPENLIST_ADMIN_PASSWORD variable on the OpenList service. It only sets the first password, so change the password in Profile, not in the variable.
  • For files stored on Railway itself, add a Local storage with the root folder /opt/openlist/data/files, which the template creates on the volume. Size the volume for the files you plan to keep there.
  • Optional variables you can add later (no prefix): SITE_URL for a custom domain in share links, TOKEN_EXPIRES_IN for the login lifetime in hours, and the DB_ settings to use MySQL or Postgres instead of SQLite.
  • Updates: the service builds from the template repo. When the pinned version is bumped, Railway shows an update notice and you choose when to apply it. Read the repo's CHANGELOG.md first.

Why Deploy OpenList on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying OpenList on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.


Template Content

More templates in this category

View Template
RustFS | (Just Updated) S3 Object Store, Public URL and Keys Set
S3-compatible object store, keys and public URL preset, volume kept

SuperSlowSloth
0
View Template
TimescaleDB
A PostgreSQL-based time-series database for analytics on Railway.

Rakit
1
View Template
NEW
Neo4j 2026.10 Community
Neo4j graph database with APOC, Browser, Bolt TCP proxy and a volume

My Projects
0