After Firefox restarts, Kaleidoscope's Configuration Wizard should appear.
Select the directory in which Kaleidoscope was installed. If you choose the wrong directory, or the installation process completed with errors, the Wizard may complain
and you will not be able to proceed until those problems are solved (try reinstalling the back-end.)
The main configuration window will show you the ports that Kaleidoscope randomly selected for its operation. You may keep them or change them. You are also asked for your Hostname.
If you have a Domain name, a Dynamic DNS domain name (recommended), or a globally routable IP address - you should enter them here. If you are behined a NAT, it is not important what
hostname you specify.
This section guides you through an installation as a client (not running a proxy server), so we keep the bottom checkbox unchecked. See below how to install Kaleidoscope to
work with an existing proxy server.
You are asked whether you are behind a NAT or not. See this Wikipedia article to learn more about NATs.
Hosts behind NATs may not be reachable from the Internet (unless port forwarding is used). Kaleidoscope uses a system of so-called mailboxes to allow hosts behind NATs to receive
data. Kaleidoscope uses some well-known mailbox servers, but you may choose a different one if you know one. (When you are connected to other contacts, Kaleidoscope will be able
to suggest new mailboxes.) If you choose an invalid mailbox, or one that is down, It will only affect your communications with other hosts behind NATs.
At this point Kaleidoscope has enough information to generate your full identity details. This is the data that you will send to your trusted friends to make them
your Kaleidoscope contacts. Admire this for a while and move on. You may copy this data to a different location or even send it now to other Kaleidoscope users. You will
always be able to view this data by using Kaleidoscope's configuration menu.
This page lets you add contacts if you already have their contact details. Moreover, you will be asked whether you would like to add a special kind of contact called
an Initial Contact. The Initial Contact is a central contact that may help you to bootstrap the system, however, since establishing trust in Kaleidoscope is a mutual process,
this will invlove sending your contact details to that central server. The data is sent over an encrypted channel authenticated by a certificate shipped with the software. Since anyone
can establish trust with the Initial Contact, we recommend that if you already know some Kaleidoscope users, then do not add the the Initial Contact. However,
If you do not know anyone using Kaleidoscope and you would still like to benefit from this system, then choose to add the Initial Contact.
That's it. All done and you are good to go. To really make use of Kaleidoscope, see the section about adding contacts.