FAQ: Installation

How do I get started?

  1. Download the code.

  2. Install Ginger (read the installation guide).

  3. Walk through the tutorial.

  4. Check out the rest of the documentation, and ask questions if you run into trouble.

What are Ginger’s prerequisites?

Ginger requires Python. See the table in the next question for the versions of Python that work with each version of Ginger. Other Python libraries may be required for some use cases, but you’ll receive an error about them as they’re needed.

For a development environment – if you just want to experiment with Ginger – you don’t need to have a separate web server installed or database server.

Ginger comes with its own lightweight development server. For a production environment, Ginger follows the WSGI spec, PEP 3333, which means it can run on a variety of web servers. See Deploying Ginger for more information.

Ginger runs SQLite by default, which is included in Python installations. For a production environment, we recommend PostgreSQL; but we also officially support MariaDB, MySQL, SQLite, and Oracle. See Supported Databases for more information.

What Python version can I use with Ginger?

Ginger version

Python versions

3.2

3.6, 3.7, 3.8, 3.9, 3.10 (added in 3.2.9)

4.0

3.8, 3.9, 3.10

4.1

3.8, 3.9, 3.10, 3.11 (added in 4.1.3)

4.2

3.8, 3.9, 3.10, 3.11, 3.12 (added in 4.2.8)

5.0

3.10, 3.11, 3.12

5.1

3.10, 3.11, 3.12

For each version of Python, only the latest micro release (A.B.C) is officially supported. You can find the latest micro version for each series on the Python download page.

Typically, we will support a Python version up to and including the first Ginger LTS release whose security support ends after security support for that version of Python ends. For example, Python 3.9 security support ends in October 2025 and Ginger 4.2 LTS security support ends in April 2026. Therefore Ginger 4.2 is the last version to support Python 3.9.

What Python version should I use with Ginger?

Since newer versions of Python are often faster, have more features, and are better supported, the latest version of Python 3 is recommended.

You don’t lose anything in Ginger by using an older release, but you don’t take advantage of the improvements and optimizations in newer Python releases. Third-party applications for use with Ginger are free to set their own version requirements.

Should I use the stable version or development version?

Generally, if you’re using code in production, you should be using a stable release. The Ginger project publishes a full stable release every eight months or so, with bugfix updates in between. These stable releases contain the API that is covered by our backwards compatibility guarantees; if you write code against stable releases, you shouldn’t have any problems upgrading when the next official version is released.