Installation instructions

The Windows installer creates a kf folder inside c:\opt\truke\ by default (you can change it during the installation). If you prefer to install a portable version, simply choose any directory and unpack the file there. This will create the same kf folder, whose structure is depicted below.

kf
├── app
│   └── file
│       ├── 7b6e211e4b3184428f93f4a872d521ec.png
│       ├── bcd44d48654fa2fbbcaf12db33643191.png
│       └── logo.png
├── data
│   ├── demo.db
│   ├── sandbox.db
│   └── store.db
├── kf.ini
├── kflauncher(.exe)
└── kfserver(.exe)

The content of the file directory may vary.

Double-click on kflauncher (available in Windows and Linux) to open a small GUI, from which you can select a database and start or stop KF. The available databases are:

store.db	The working database, empty after install
demo.db	An example database
sandbox.db	A copy of demo.db. Do your experiments with this one

Remember that KF is a web server. After start it normally opens a browser window from where you start working. This behavior can be disabled (i.e., do not open a browser window after each start) by editing the kf.ini file, changing the line browser = true to browser = false. The URL to interact with KF locally is http://localhost. It may happen that the browser starts with an URL that has a number in it, such as http://localhost:81; that means that port 80 is used by another process, and KF keeps trying different ports until it finds one that is free. The default port is 80, but you can change that in kf.ini.

kfserver is the command line version of kflauncher. It just starts the server without any GUI, saving some RAM.