Comprehensive installation instructions? about klondike

[chriseldredge]

I agree some setup instructions would be useful. In the meantime, setup is actually intended to be simple:

• Start with IIS and asp.net 4.5.1+ installed
• Either download a binary zip and unzip it somewhere or clone the binary repo somewhere
• Edit the web.config adjusting appSettings as desired
• Create a new IIS site and app pool

Can you elaborate on which of these steps is not obvious or any problems you encountered?

[nathan-alden-sr]

It's good to read that it's so simple. 👍 Yes, it would be nice if these instructions were in the README.

[webframp]

• Edit the web.config adjusting appSettings as desired

Is there perhaps more info on the possible settings for these?

[chriseldredge]

There are comments inline with the settings in Web.config on master.

The self-host branch is the current branch of active development for the next release. The README on this branch has more details about deploying Klondike and building it from source.

[chriseldredge]

The README in master now has more comprehensive set up instructions. Please note I haven't made an official release yet, so these instructions apply to recent AppVeyor builds or builds from source for the time being.

[jhurdlow]

I can't find any info on how to set passwords in the readme (or anywhere else). Can't "Sign In" without a password, but there doesn't appear to be any way to set one. Also, will WindowsAuth be coming to the IIS hosted version?

[chriseldredge]

Updated the README to add some notes on authentication. Windows auth is already supported in IIS hosted version. You enable it in IIS Manager with Basic/NTLM authentication modules.

[penartur]

I followed the instructions, yet it does not work; requests to /api/ return 404. It is as if the application itself did not start, and did not set up the routes, so that only static files (e.g. index.html) are served.

Looking at the Web.config, I don't see any entry point. How is IIS supposed to start up the application (or anything at all)? Maybe I'm missing something?

[chriseldredge]

@penartur Please open a new issue with more information, including what version of Klondike you are using, what version of IIS, and the contents of ~/App_Data/Logs/Klondike.log.

[penartur]

@chriseldredge Never mind, it is just that ASP.NET wasn't completely installed on that machine.
(Logs folder, obviously, was empty)