You can just fork or clone this repository and use it as is.
✨ It just works. ✨
Create env file using example file
cp .env.example .envYou can then update configs in the .env files to customize your configurations.
Before deploying it, make sure you change at least the values for:
SECRET_KEYFIRST_SUPERUSER_PASSWORDPOSTGRES_PASSWORD
You can (and should) pass these as environment variables from secrets.
Read the deployment.md docs for more details.
Some environment variables in the .env file have a default value of changethis.
You have to change them with a secret key, to generate secret keys you can run the following command:
python -c "import secrets; print(secrets.token_urlsafe(32)[:32])"Copy the content and use that as password / secret key. And run that again to generate another secure key.
This is a dockerized setup, hence start the project using below command
docker compose watchThis should start all necessary services for the project and will also mount file system as volume for easy development.
You verify backend running by doing health-check
curl http://[your-domain]:8000/api/v1/utils/health-check/or by visiting: http://[your-domain]:8000/api/v1/utils/health-check/ in the browser
Backend docs: backend/README.md.
General development docs: development.md.
This includes using Docker Compose, custom local domains, .env configurations, etc.
Deployment docs: deployment.md.
This project was created using full-stack-fastapi-template. A big thank you to the team for creating and maintaining the template!!!