Kitsune is the platform that powers SuMo (support.mozilla.org)
It is a Django application. There is documentation online.
You can access the staging site at https://support.allizom.org/
See what's deployed
By participating in this project, you're agreeing to uphold the Mozilla Community Participation Guidelines. If you need to report a problem, please see our CODE_OF_CONDUCT.md guide.
To get Kitsune running locally all you really need is to have Docker and Docker Compose installed, and follow the following steps.
-
Fork this repository & clone it to your local machine.
git clone https://github.com/mozilla/kitsune.git
-
Pull base Kitsune Docker images, run
collectstatic
, create your database, and install node packages.make init make build
-
Run Kitsune.
make run
This will produce a lot of output (mostly warnings at present). When you see the following the server will be ready:
web_1 | Starting development server at http://0.0.0.0:8000/ web_1 | Quit the server with CONTROL-C.
The running instance will be located at http://localhost:8000/ unless you specified otherwise, and the administrative control panel will be at http://localhost:8000/admin/.
Another way you might choose to run the app (step 3 above) is by getting a shell in the container and then manually running the Django dev server from there. This should make frequent restarts of the server a lot faster and easier if you need to do that:
make runshell
bin/run-dev.sh
The end result of this method should be the same as using make run
, but will potentially aid in debugging
and act much more like developing without Docker as you may be used to. You should use make runshell
here
instead of make shell
as the latter does not bind port 8000 which you need to be able to load the site.
Run make help
to see other helpful commands.
Finally you can run the development server with instance reloading through browser-sync.
npm start
The running instance in this case will be located at http://localhost:3000/.
After the above you can do some optional steps if you want to use the admin:
-
Enable the admin control panel
echo "ENABLE_ADMIN=True" >> .env
-
Create a superuser
docker-compose exec web ./manage.py createsuperuser
-
Create some data
docker-compose exec web ./manage.py generatedata
-
Update product details
docker-compose exec web ./manage.py update_product_details
First, make sure you have run the "Create some data" step above.
- Enter the web container:
docker-compose exec web bash
- Build the indicies:
./manage.py esreindex
(You may need to pass the--delete
flag) - Precompile the nunjucks templates:
./manage.py nunjucks_precompile