aboutsummaryrefslogtreecommitdiffstats
path: root/docs/installing/manual_install.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/installing/manual_install.md')
-rw-r--r--docs/installing/manual_install.md23
1 files changed, 12 insertions, 11 deletions
diff --git a/docs/installing/manual_install.md b/docs/installing/manual_install.md
index d3a629155..d523a199a 100644
--- a/docs/installing/manual_install.md
+++ b/docs/installing/manual_install.md
@@ -175,20 +175,20 @@ Create a `foi` user from the command line, like this:
_Note:_ Leaving the password blank will cause great confusion if you're new to
PostgreSQL.
-Then create the databases:
+We'll create a template for our Alaveteli databases:
+
+ # sudo -u postgres createdb -T template0 -E UTF-8 template_utf8
+ # echo "update pg_database set datistemplate=true where datname='template_utf8';" > /tmp/update-template.sql
+ # sudo -u postgres psql -f /tmp/update-template.sql
- # sudo -u postgres createdb -T template0 -E SQL_ASCII -O foi foi_production
- # sudo -u postgres createdb -T template0 -E SQL_ASCII -O foi foi_test
- # sudo -u postgres createdb -T template0 -E SQL_ASCII -O foi foi_development
+Then create the databases:
-We create using the ``SQL_ASCII`` encoding, because in postgres this is means
-"no encoding"; and because we handle and store all kinds of data that may not
-be valid UTF (for example, data originating from various broken email clients
-that's not 8-bit clean), it's safer to be able to store *anything*, than reject
-data at runtime.
+ # sudo -u postgres createdb -T template_utf8 -O foi foi_production
+ # sudo -u postgres createdb -T template_utf8 -O foi foi_test
+ # sudo -u postgres createdb -T template_utf8 -O foi foi_development
-Now you need to set up the database config file to contain the name, username
-and password of your postgres database.
+Now you need to set up the database config file so that the application can
+connect to the postgres database.
* Copy `database.yml-example` to `database.yml` in `alaveteli/config`
* Edit it to point to your local postgresql database in the development
@@ -198,6 +198,7 @@ Example `development` section of `config/database.yml`:
development:
adapter: postgresql
+ template: template_utf8
database: foi_development
username: foi
password: secure-password-here