\newcommand{\FT}{\mathcal{F}}

Pages

Manual

Get­ting started with your Kiwilight.​com ac­count

Use kpasswd to set your pass­word. The of­fi­cial sup­port venue is ##kiwilight on freenode.net.

If you are a tunnel user then you should as­sume that home di­rec­tory or ~ refers to /tmp for you - you can use groups to check your af­fil­i­a­tions. This is the only lo­ca­tion where you have write ac­cess to the filesys­tem.

How to Con­fig­ure SSH — To use pub­lic key au­then­ti­ca­tion with SSH you will need to load the keys into the LDAP data­base. OpenSSH will not look in ~/.ssh/authorized_keys. First use klist to re­trieve to show your Ker­beros tick­ets. The out­put should look like
Credentials cache: FILE:/tmp/krb5cc_1000
        Principal: kaiting.chen@KIWILIGHT.COM

  Issued           Expires          Principal
Nov 21 16:55:23  Nov 22 02:55:23  krbtgt/KIWI...
If you do not have an un­ex­pired ticket from krbtgt then you should use kinit to get one. Ver­ify that the klist out­put shows a valid ticket from krbtgt be­fore pro­ceed­ing.

The rec­om­mended asym­met­ric key for­mat is 4096 bit RSA. You are free to choose what­ever key for­mat you would like, but please do not use DSA keys. They are in­se­cure, the tech­nol­ogy is stu­pid and un­nec­es­sary, and they do not work with the OpenSSH con­fig­u­ra­tion on the server.

Please en­sure that each of your SSH pub­lic keys has a unique com­ment at the end. For ex­am­ple this is my pub­lic key.
ssh-rsa AAAAB3NzaC1yc2EAAAABJQAAAgEAoQl5LgDttB6wFly3weo
scjWAUT06yHs9rq6pgWS8CDd/Ylk9c4/02Zu9bdxby5yZkALkUpknp4
... snip ...
8KCdvcKokBZF1rOb0A1nJ6LZYM02pLmV8iCmWrtisJFZPk7XCxn3yqs
NUqkEkotKxnuOmxwf8dnq94hIzJ/zUP1IT0nAFFRVeJyxhrr+Ndsps=
 kaiting.chen@kiwilight.com
You can see that it is tagged as kaiting.chen@kiwilight.com. Do not up­load two keys with the same com­ment.

After you have ver­i­fied that your pub­lic key is com­pli­ant up­load your pub­lic key to ~/pick_a_filename and use:
kchlpk insert ~/the_filename_you_picked
to in­sert it into the data­base. If you use kchlpk you should see it re­ported in the list. If all is well you should delete the up­loaded file.

Note that kchlpk insert ex­pects one pub­lic key per file. You should not do:
Wrong!
kchlpk insert ~/.ssh/authorized_keys

un­less you are ab­solutely cer­tain that there is only one pub­lic key in that file.

To re­move a key from the data­base you should use:
kchlpk remove index_number
where index_number is the num­ber be­fore the key in the kchlpk out­put.

Please re­move ~/.ssh/authorized_keys when are fin­ished in­sert­ing all of your SSH pub­lic keys into the data­base.

How Mail Works — You can re­ceive mail on the Kiwilight.​com server at your.username@kiwilight.com. Typ­i­cally this will be routed to the mail ad­dress you pro­vided at reg­is­tra­tion, which I will refer to as your ex­ter­nal ad­dress.

If you are a tunnel user then all mail is routed to your ex­ter­nal ad­dress.

If you are a turtle user then you have local stor­age and this be­comes more com­pli­cated. Mail to:
your.username@kiwilight.com
is routed to your ex­ter­nal ad­dress. Mail that you re­ceive at:
your.username@localhost or your.username
is stored on the server lo­cally. This be­hav­ior can be forced using the +local suf­fix so mail to:
your.username+local@kiwilight.com
will be stored lo­cally rather than being routed to your ex­ter­nal ad­dress. You may also route your local mail else­where with:
echo 'other_mail_address@wherever.tld' > ~/.forward
Your local mail ac­count can be ac­cessed through Round­cube at: http://mail.kiwilight.com/. This is not yet work­ing.

How to Use HTTPD — The Kiwilight.​com server runs Apache HTTPD with mod­_fcgid to allow turtle users to host sites and ap­pli­ca­tions. Cur­rently the PHP is the only server side script­ing lan­guage sup­ported.

The main site lo­cated at http://www.kiwilight.com/ of­fers a directory/ of all turtle users on the server. It also of­fers the full con­fig­u­ra­tion of the server minus se­crets and pass­words in the etc/ di­rec­tory.

If you would like to host a web site you should cre­ate the ~/.public/ di­rec­tory with mode 755 if it does not al­ready exist. This di­rec­tory can be ac­cessed at:
http://www.kiwilight.com/~your.username/
Note that httpd must be able to ac­cess ~/.public/ for this to work; for this rea­son we highly rec­om­mend against set­ting your home di­rec­tory mode 700. httpd will read this di­rec­tory with Option Indexes ExecCGI which will allow pretty di­rec­tory in­dexes to be gen­er­ated and scripts to ex­e­cute. It is not nec­es­sary - and we rec­om­mend against - set­ting your scripts to mode 755 or 700.