xssbook2/README.md

43 lines
1,015 B
Markdown
Raw Normal View History

2024-05-20 21:11:38 +00:00
## xssbook
### description
who doesn't want to run non free javascript
now with xssbook you can run as much stallman disapprovement as you want
- all inputs on the site are unfiltered
- api calls dont care what you send them as long as they are valid strings
- upload anyfiles to be your profile avatar and banner (even adobe flash!!!)
### installation
2024-12-23 16:13:27 +00:00
To get the checkout run:
2024-05-20 21:11:38 +00:00
2024-12-23 16:13:27 +00:00
```sh
2024-05-20 21:11:38 +00:00
git clone https://g.freya.cat/freya/xssbook2 xssbook2
cd xssbook2
```
2024-12-23 16:13:27 +00:00
XSSBook v2 runs in docker compose. To run, you MUST do ALL of the following:
2024-05-20 21:11:38 +00:00
2024-12-23 16:13:27 +00:00
- Update PROJECT_DIR in .env to be an absolute path to your current directory
- Build all css source from sass by running `make`
- Use `site/compose` instead of docker compose
Finally, to build the images and start, run:
2024-05-20 21:11:38 +00:00
2024-12-23 16:13:27 +00:00
```sh
./site/compose build --pull
./site/compose up -d
```
> NOTE: You many want to change is HTTP_PORT and HTTP_BIND in .env.
2024-05-20 21:11:38 +00:00
2024-12-23 16:13:27 +00:00
### migrating from xssbook v1
2024-05-20 21:11:38 +00:00
2024-12-23 16:13:27 +00:00
See `shim/README.md`
2024-05-20 21:11:38 +00:00
### license
2024-12-23 16:13:27 +00:00
This project is licensed under the GNU GPLv3.