mirror of
https://github.com/minetest/contentdb.git
synced 2024-11-09 17:13:45 +01:00
63 lines
1.7 KiB
Markdown
63 lines
1.7 KiB
Markdown
# Getting started
|
|
|
|
Docker is the recommended way to develop and deploy ContentDB.
|
|
|
|
1. Install `docker` and `docker-compose`.
|
|
|
|
Debian/Ubuntu:
|
|
|
|
sudo apt install docker-ce docker-compose
|
|
|
|
2. Copy `config.example.cfg` to `config.cfg`.
|
|
|
|
1. Set `SECRET_KEY` and `WTF_CSRF_SECRET_KEY` to different random values.
|
|
|
|
3. (Optional) Set up mail in config.cfg.
|
|
Make sure to set `USER_ENABLE_EMAIL` to True.
|
|
|
|
4. (Optional) Set up GitHub integration
|
|
1. Make a GitHub OAuth Client at <https://github.com/settings/developers>:
|
|
2. Homepage URL - `http://localhost:5123/`
|
|
3. Authorization callback URL - `http://localhost:5123/user/github/callback/`
|
|
4. Put client id and client secret in `GITHUB_CLIENT_ID` and `GITHUB_CLIENT_SECRET` in config.cfg.
|
|
|
|
5. Create config.env:
|
|
|
|
POSTGRES_USER=contentdb
|
|
POSTGRES_PASSWORD=password
|
|
POSTGRES_DB=contentdb
|
|
FLASK_DEBUG=1
|
|
|
|
6. Start docker images:
|
|
|
|
docker-compose up --build
|
|
|
|
7. Setup database:
|
|
|
|
./utils/run_migrations.sh
|
|
|
|
8. Create initial data
|
|
1. `./utils/bash.sh`
|
|
2. Either `python utils/setup.py -t` or `python utils/setup.py -o`:
|
|
1. `-o` creates just the admin, and static data like tags, and licenses.
|
|
2. `-t` will do `-o` and also create test packages. (Recommended)
|
|
|
|
9. Make uploads writable:
|
|
|
|
sudo chown $(whoami):5123 -R data/uploads
|
|
|
|
10. View at <http://localhost:5123>.
|
|
The admin username is `rubenwardy` and the password is `tuckfrump`.
|
|
|
|
In the future, starting CDB is as simple as:
|
|
|
|
docker-compose up --build
|
|
|
|
To hot/live update CDB whilst it is running, use:
|
|
|
|
./utils/reload.sh
|
|
|
|
This will only work with python code and templates, it won't update tasks or config.
|
|
|
|
Now consider reading the [Developer Introduction](dev_intro.md).
|