NOT YET RELEASED LOCKSS 2.0-beta1 System Manual

Welcome to the NOT YET RELEASED LOCKSS 2.0-beta1 System Manual.

Last modified: 2022-06-07

What's New?

What's New in 2.0-beta1?



In order to install and test the LOCKSS 2.0-beta1 system, you will need:

  • 64-bit Linux host (physical or virtual) with at least 4 CPU cores and 8 GB of memory, and adequate storage.

  • Commonplace Linux system utilities like curl/wget and tar to run the LOCKSS Downloader and the LOCKSS Installer.

  • K3s, a lightweight Kubernetes environment (installed via the LOCKSS Installer).

See System Prerequisites and Installing the LOCKSS System for more details.


See Upgrading From LOCKSS 2.0-alpha5 for upgrade instructions from 2.0-alpha5.

Questions and Answers

I have an existing classic LOCKSS system (version 1.x). Can I upgrade to LOCKSS 2.0-beta1?


The LOCKSS 2.0-beta1 release is a technology preview which we are excited to share with the community for testing purposes. It is not yet possible to convert from a classic LOCKSS system (e.g. version 1.75.8) to a LOCKSS 2.0 system for production purposes.

However, an upcoming version of the classic LOCKSS system will contain an experimental tool to test the migration of select archival units (AUs) from a production 1.x system to a test 2.x system.

To help us advance toward the final LOCKSS 2.0 release, please consider installing and running the LOCKSS 2.0-beta1 release on a test machine and providing us with your feedback.

I have a LOCKSS system running 2.0-alpha5. Can I upgrade to LOCKSS 2.0-beta1?

Yes. You are welcome to wipe your testing data from LOCKSS 2.0-alpha5 and start from scratch, but there is an upgrade path from LOCKSS 2.0-alpha5.

Can I use my own PostgreSQL database? Can I use my own Solr database?

Yes, you can configure the system to use your institution's Postgres database and/or Solr database -- or you can simply let system run included ones locally.

Can I replay Web content with my own Pywb instance? Can I replay Web content with my own OpenWayback instance?

Yes, you can configure your own Pywb instance and/or OpenWayback instance to connect directly to the LOCKSS Repository Service -- or you can let the system run included ones locally, or you can choose not to run any Web replay engine at all.

Contact Us

Please contact us for questions, feedback and bug reports. Open a ticket by sending e-mail to . Your contribution toward the final LOCKSS 2.0 release is very important to us and greatly appreciated by the community.