> For the complete documentation index, see [llms.txt](https://unicef.gitbook.io/unpp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://unicef.gitbook.io/unpp/technical-documentation/development-setup.md).

# Development Setup

## Local Setup

1. Install [Docker](https://docs.docker.com/engine/installation/) for your OS. Also install Fabric via\
   `pip install fabric`
2. Create .env file with the reference of`.env.example`or receive .env file from your team member.
3. Run`fab up`
4. Go to <http://127.0.0.1:8080/> to see the React frontend running. The Django app is running under

   <http://127.0.0.1:8080/api/>
5. Run `fab fakedata`
   * create mock data like account, partner agencies, etc.
6. Go to <http://127.0.0.1:8080/login> login with <fake-user-72@unicef.org>/Passw0rd! and can now go t

## Fabric commands

For convenience some [fabric](http://www.fabfile.org/) commands are included, such as getting into Django app container

```
fab ssh:backend
```

or running tests

```
fab tests
```

For the most up-to-date reference just check `fabfile.py` in the repository root.