This repository represents a customized extension of pywb for use with the UK Web Archive. It includes:
- Custom UI for UKWA
- Single-Concurrent Lock System
- Localization
- Access Controls
- HTTP/S Proxy Mode
- Memento Prefer Header initial implementation (See this issue for further discussion)
This repository ships a custom package ukwa_pywb
, which extends the pywb
.
Currently, it is to be used with the ukwa/pywb fork of pywb until this fork is merged into a future pywb release.
To build and run from a checked-out repository, you can use the integration test setup. First
cd integration-test/
Then you can use this to re-build the containerised version locally:
docker-compose build pywb
And run it using:
docker-compose up populate pywb
The first time you do this, the populate
container will make the test data available and populate the system with it. You will need to do this again if you fully remove the integration testing containers. However, if you're just re-building pywb
for testings, you can just do this:
docker-compose up pywb
When running locally, the service should be available at: http://localhost:8081 and should contain:
- A copy of the The Archival Acid Test: http://localhost:8081/open-access/*/http://acid.matkelly.com/
- Example HTTP 451 resource: http://localhost:8081/open-access/20180203004147/http://www.cs.odu.edu/~mkelly/acid/externalScript.js
See Integration Tests for more details.
The project can be deployed locally or in Docker.
-
See Deployment for more information about deploying this repository and running tests.
-
See Configuration for more information about the
config.yaml
file and its options. -
See Integration Tests on how to run the included integration test suite.