diff options
| author | JocelynDelalande <JocelynDelalande@users.noreply.github.com> | 2018-07-17 00:22:23 +0200 |
|---|---|---|
| committer | Alexis Metaireau <alexis@notmyidea.org> | 2018-07-17 00:22:23 +0200 |
| commit | 9caf213e1d4f2f92944000f2c072fcece885f407 (patch) | |
| tree | f459158e67825c2316e4274b499ea96691854b2c /docs/installation.rst | |
| parent | 026c1ec4aaa7ea758b16f01f4842630228c38907 (diff) | |
| download | ihatemoney-mirror-9caf213e1d4f2f92944000f2c072fcece885f407.zip ihatemoney-mirror-9caf213e1d4f2f92944000f2c072fcece885f407.tar.gz ihatemoney-mirror-9caf213e1d4f2f92944000f2c072fcece885f407.tar.bz2 | |
Document MySQL setup (#357)
PyMySQL is more difficult to install since its version 0.9 since it now depends
on *cryptography* lib, which in turns depends on OpenSSL and Python dev files.
See https://github.com/PyMySQL/PyMySQL/issues/697
Diffstat (limited to 'docs/installation.rst')
| -rw-r--r-- | docs/installation.rst | 20 |
1 files changed, 19 insertions, 1 deletions
diff --git a/docs/installation.rst b/docs/installation.rst index e7d586e..4829c5d 100644 --- a/docs/installation.rst +++ b/docs/installation.rst @@ -63,6 +63,22 @@ Once installed, you can start a test server:: And point your browser at `http://localhost:5000 <http://localhost:5000>`_. +Configure database with MySQL/MariaDB (optional) +================================================ + +Only required if you prefer MySQL/MariaDB over SQLite. + +1. Install PyMySQL dependencies. On Debian or Ubuntu, that would be:: + + apt install python3-dev libssl-dev + +2. Install PyMySQL (within your virtualenv):: + + pip install 'PyMySQL>=0.9,<0.10' + +3. Create an empty database and a database user +4. Configure :ref:`SQLALCHEMY_DATABASE_URI <configuration>` accordingly + Deploy it ========= @@ -159,6 +175,8 @@ For example, use the following command to add more gunicorn workers:: docker run -d -p 8000:8000 ihatemoney -w 3 +.. _configuration: + Configuration ============= @@ -187,7 +205,7 @@ Production values are recommended values for use in production. | | | **Production value:** `ihatemoney conf-example ihatemoney.cfg` sets it to something | | | | random, which is good. | +-------------------------------+---------------------------------+----------------------------------------------------------------------------------------+ -| MAIL_DEFAULT_SENDER | ``("Budget manager", | A python tuple describing the name and email address to use when sending | +| MAIL_DEFAULT_SENDER | ``("Budget manager", | A python tuple describing the name and email address to use when sending | | | "budget@notmyidea.org")`` | emails. | | | | | | | | **Production value:** Any tuple you want. | |