Manual setup

First, install [PostgreSQL](https://www.postgresql.org/download/) on your machine and run it. *pythondotorg* currently uses Postgres 15.x.

First, install[PostgreSQL](https://www.postgresql.org/download/)on your machine and run it.*pythondotorg*currently uses Postgres 15.x.

Then clone the repository:

And then you'll need to install dependencies. You don't need to use `pip3` inside a Python 3 virtual environment:

And then you'll need to install dependencies. You don't need to use`pip3`inside a Python 3 virtual environment:

*pythondotorg* will look for a PostgreSQL database named `pythondotorg` by default. Run the following command to create a new database:

*pythondotorg*will look for a PostgreSQL database named`pythondotorg`by default. Run the following command to create a new database:

To change database configuration, you can add the following setting to `pydotorg/settings/local.py` (or you can use the `DATABASE_URL` environment variable):

To change database configuration, you can add the following setting to`pydotorg/settings/local.py`(or you can use the`DATABASE_URL`environment variable):

If you prefer to use a simpler setup for your database you can use SQLite. Set the `DATABASE_URL` environment variable for the current terminal session:

If you prefer to use a simpler setup for your database you can use SQLite. Set the`DATABASE_URL`environment variable for the current terminal session:

Whichever database type you chose, now it's time to run migrations:

To compile and compress static media, you will need *compass* and *yui-compressor*:

To compile and compress static media, you will need*compass*and*yui-compressor*:

To create initial data for the most used applications, run:

See [create_initial_data](https://pythondotorg.readthedocs.io/commands.html#command-create-initial-data) for the command options to specify while creating initial data.

See`pythondotorg`[create_initial_data](https://pythondotorg.readthedocs.io/commands.html#command-create-initial-data)for the command options to specify while creating initial data.

Finally, start the development server:

Optional: Install Elasticsearch

The search feature in Python.org uses Elasticsearch engine. If you want to test out this feature, you will need to install [Elasticsearch](https://www.elastic.co/downloads/elasticsearch).

The search feature in Python.org uses Elasticsearch engine. If you want to test out this feature, you will need to install[Elasticsearch](https://www.elastic.co/downloads/elasticsearch).

Once you have it installed, update the URL value of `HAYSTACK_CONNECTIONS` settings in `pydotorg/settings/local.py` to your local ElasticSearch server.

Once you have it installed, update the URL value of`HAYSTACK_CONNECTIONS`settings in`pydotorg/settings/local.py`to your local ElasticSearch server.

Generating CSS files automatically

Due to performance issues of [django-pipeline](https://github.com/jazzband/django-pipeline/issues/313), we are using a dummy compiler `pydotorg.compilers.DummySASSCompiler` in development mode. To generate CSS files, use `sass` itself in a separate terminal window:

Static files are automatically compiled inside the[Docker Compose`static` container](../../docker-compose.yml)

when running`make serve`.

When your pull request has stylesheet changes, commit the`.scss` files and the compiled`.css` files.

Otherwise, ignore committing and pushing the`.css` files.

Running tests

Generate an HTML report with `coverage html` if you like.

Generate an HTML report with`coveragehtml`if you like.

Useful commands