Welcome to Dwarf Fortress Storyteller

Database on Windows

It looks like you are using Windows, if not go to the Linux or macOS page.

There are 2 options for databases, Postgres and SQLite. Look in the sections below for the right configuration.

SQLite

Because installing SQLite is to complicated to install on Windows we have additional packages imbedded in the executable on the Windows version. This means you do not have to install SQLite on Windows.

Postgres

NOTE: If you use the SQLite version of DF Storyteller you don't need PostgreSQL!

1. Install PostgreSQL: Download. Minimum version unknown at the moment.
2. Check on selected components (at least): 'PostgreSQL Server' and 'Command Line Tools' ('pgAdmin' is also good to have to make things easier.)
3. Write down the postgres password you use.
4. If you change the port, write this down to. Default is 5432.

Because windows makes things difficult you have to take a few extra steps. (Some steps might be different depending on the language and version of your system.) Following steps are tested on Windows 10:

1. Open File Explorer
2. Right-click on "This PC" (in the left bar) and select "Properties"
3. In the new window click on "Advanced system settings"
4. In the new window click "Environment Variables..." (in the "Advanced" tab)
5. In the new window again, in the top section "User variables for <username>"
6. Double-click on "Path"
7. In that window click "New" and paste or type C:\Program Files\PostgreSQL\12\bin and hit Enter.
8. Click "New" again and paste or type C:\Program Files\PostgreSQL\12\lib and hit Enter.
9. Now click "OK" on the last 3 windows and you can close the others.
10. You might need to reboot before the changes take effect.

Build from source

If you want to build DF Storyteller from source you need to install Postgres (including its development packages).