diff options
author | Freya Murphy <freya@freyacat.org> | 2024-12-23 11:13:27 -0500 |
---|---|---|
committer | Freya Murphy <freya@freyacat.org> | 2024-12-23 11:13:27 -0500 |
commit | 5a2ba9c2e7605bb788bc406184547d22c6436867 (patch) | |
tree | cbd988d534e8a8593a31d70571222443f80da0b3 /README.md | |
parent | fix about modal (diff) | |
download | xssbook2-5a2ba9c2e7605bb788bc406184547d22c6436867.tar.gz xssbook2-5a2ba9c2e7605bb788bc406184547d22c6436867.tar.bz2 xssbook2-5a2ba9c2e7605bb788bc406184547d22c6436867.zip |
v2.1.0, refactor w/ crimson
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 31 |
1 files changed, 17 insertions, 14 deletions
@@ -8,32 +8,35 @@ 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!!!) -- /apidocs for api documentation ### installation -XXSBook v2 is a multi docker image setup. To run, download the repoistory, build the docker images, and then start the stack. +To get the checkout run: -``` -# download the images +```sh git clone https://g.freya.cat/freya/xssbook2 xssbook2 cd xssbook2 -# build and run the stack -docker compose pull -docker compose build -docker compose up -d ``` -The only configuration that you many want to change is the http port listed in the docker compose file. By default this is set to port 80, but it can be changed to whatever you want. +XSSBook v2 runs in docker compose. To run, you MUST do ALL of the following: -### migrating from xssbook v1 + - 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: -If you are runing a xssbook v1 setup, the database is fully incompatible with xssbook v2. Luckily there is a migration that exists to port over your data. XSSBook v1 has a single sqlite database file and a custom assets directory likly called `custom`. You will know you have the right directory if there are two sub directories called `avatar` and `banner`. Place the sqlite db file (called `xssbook.db`) and the `custom` directory in the `data/shim` folder of the xssbook v2 directory. If this doesnt exist please do a full setup of v2 first. Then run `docker compose up -d shim`, and you should be all set. +```sh +./site/compose build --pull +./site/compose up -d +``` + +> NOTE: You many want to change is HTTP_PORT and HTTP_BIND in .env. -> WARNING: This will delete ALL data in the database if you specify xssbook v1 files in the data path. Make sure yo only run this once and remove the files once completed. +### migrating from xssbook v1 -> NOTE: the migration will never run if the database files are not supplied. +See `shim/README.md` ### license -This project is licensed under the MIT license +This project is licensed under the GNU GPLv3. |