forum/README.md

44 lines
1.6 KiB
Markdown
Raw Normal View History

2023-10-21 23:59:10 -04:00
# Xenforo StP Repo
2023-10-23 07:25:46 +00:00
## Downloading and building (run as root or enable docker rootless)
```
curl -sSfL get.docker.com | bash
```
2023-10-21 23:59:10 -04:00
```
git clone https://git.myco.systems/stp/xenforo.git
```
```
cd xenforo
```
2023-10-23 07:25:46 +00:00
Place xenforo files at xenforo/_data (or alter the directory to match your Xenforo location) mysql can be pointed anywhere, but you should have a persistent directory so you can enter the container and import your db.
2023-10-21 23:59:10 -04:00
```
docker compose build
```
2023-10-23 07:25:46 +00:00
## Running
2023-10-21 23:59:10 -04:00
```
docker compose up -d
```
2023-10-23 07:25:46 +00:00
To import your mysql db you need to move your .sql files into a location that the container is attached to then run `docker exec -it <docker-container-id> /bin/bash` > `cd /var/lib/mysql` (assuming this is the directory the container is attached to) > `mariadb -u <username> -p <db-name> < <your-existing-db>` enter your password and then get a coffee because any databases over 1 GB can take a while.
Restart the containers
```
docker compose down && docker compose up
```
After that the nginx webserver will be running on port 8080, currently the expected behavior is for nginx to be behind a reverse proxy so either you can point the proxy at your-ip:8080 or you can alter the docker compose file to include traefik which can grab ssl certificates for you.
---
## Issues
To report an issue go to https://git.myco.systems/stp/xenforo/src/branch/main/ISSUES.md and copy the raw markdown, then head over to https://git.myco.systems/stp/xenforo/issues and press "New Issue"
## License
All code is licensed under MIT, no rights reserved, no warranty provided.
https://git.myco.systems/stp/xenforo/src/branch/main/LICENSE