Getting Started With Kutoken
We've tried to make Kutoken as simple as possible to use. Here's a simple guide taking you from the moment after you purchase your machine until your first app is deployed - a journey that should take less than 20 minutes.
Start your machine
Log into your control panel.
Kutoken machines typically take between 10 and 15 minutes to be provisioned, so if you've only just placed your order your machine
may not be ready yet. Once it is, you'll see a screen like that below - simply
click on Start and your machine will be powered on.
Connect to your VM over SSH
Now we've prepared everything you can connect to your new Kutoken virtual machine over SSH. The initial username will be kutoken, and the password will
be the same as you used to access the control panel. If you've
forgotten the IP address of your VM (it was sent to you by email) you can view it by clicking on the green down arrow next to the VM name on the 'Control' tab.
If you're ever unable to SSH to your machine (for example, you've put in bad firewall rules, or messed up the network config) then you can also find details on how to connect to the console via VNC here.
Deploy your application
Once you've copied your app onto your new Kutoken machine, you'll need to install any external dependencies. Kutoken makes this very easy, because many Django applications have been pre-packaged for you.
Now, we need to edit the settings.py and enter the database settings.
If you want to use Kutoken extensions, which will automagically create your Apache or Nginx configuration for you, add 'kutoken_extensions' to your INSTALLED_APPS.
Optional: Configure Apache
As long as you've added kutoken_extensions to your INSTALLED_APPS you can simply run './manage.py apacheconf' to generate a suitable WSGI and Apache config. Please note that if you're not using django.contrib.sites, or it's not configured in your database yet, then you'll need to manually set the 'ServerName' in your Apache config.
Alernative: Configure Nginx
Once kutoken_extensions is added to your INSTALLED_APPS you can configure Nginx by running
sudo ./manage.py nginxconf
You'll need to install some packages for Nginx and Fastcgi, but the command will tell you exactly what you need to do.
As with the Apacheconf command, if your site name isn't set in the Django sites app you'll need to manually edit the nginx config at /etc/nginx/sites-enabled/<appname>
Relax
Your app is now up and running on Kutoken.
