Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/webis-de/wasp


https://github.com/webis-de/wasp

Last synced: about 2 months ago
JSON representation

Lists

README

        

# WASP
Personal web archive and search as a container.

## Quickstart
- Install [Docker](https://docker.io) (Windows 10: use Pro or Education)
- `docker run -p 127.0.0.1:8001:8001 -p 127.0.0.1:8002:8002 --name wasp -d ghcr.io/webis-de/wasp:0.4.2`
- Configure your browser to use `localhost:8001` as proxy HTTP+HTTPS (exception: `localhost`)
- Clear browser cache or otherwise ensure your browser actually requests the web pages
- Visit [http://example.org](http://example.org)
- Visit [http://localhost:8002/search](http://localhost:8002/search) and search for "example"

## HTTPS
For HTTPS you have to trust the certificate of your personal WASP instance (generated on the first run).
- `docker cp wasp:/home/user/app/pywb/proxy-certs/pywb-ca.pem .`
- Configure your browser to trust this certificate **as an authority** to identify web pages

## Other commands
- `docker stop wasp`
- `docker start wasp`

## Troubleshooting
- The search page never retrieves results/does not show new results!
- WASP currently uses the default Elastic Search settings which turn the index read-only once your disk reaches 95% of used space. Since the index is (if you did not reconfigure that) stored on your root partition, you might need to clean up there.