diff --git a/page/getting_started/index.html b/page/getting_started/index.html
index 73d417d9..1e5629be 100644
--- a/page/getting_started/index.html
+++ b/page/getting_started/index.html
@@ -96,32 +96,46 @@
Setup your environment
sudo shutdown -r now
-Preparing a new Project
+Prepare a new Project
-The command kanku init
will create a default Kankufile
-which should give you a good starting point.
+In Kanku, a "project" is a file, usually called KankuFile
, which is
+associated with a libvirt domain (which means a VM, in libvirt terminology).
-The option --memory=...
defines the RAM of the virtual guest and is optional.
-Default is 2G of RAM.
-For more options SEE kanku init --help
+The easiest way to manage your projects is to keep them in individual
+directories (it is also possible to have a single directory containing
+multiple Kankufiles, but this is slightly more complicated):
# create directory
mkdir MyProject
# cd in project's directory
cd MyProject
+
-kanku init --memory=2G --domain_name my-project
+The command kanku init
will create a default KankuFile
in the current
+directory, which should give you a good starting point.
+
+The option --memory=...
defines the RAM of the virtual guest and is optional.
+The default is 2G of RAM. For more options, see kanku init --help
.
+
+kanku init --memory=2G --domain_name my-project
-Download, create and start a new guest
+(The --domain_name
option is not required: if not given, kanku will assign
+a default domain name. However, this can lead to name collisions later on when
+you create a second VM!)
+
+Create a VM
+
+Now, kanku init
only creates the KankuFile
in your project directory. To
+create the VM, issue the command:
kanku up
-Connect to new machine
+Connect to the VM
-Per default, if it exists, your ssh key is added to the authorized keys file
+Per default, if it exists, your ssh key is added to the authorized keys file.
Otherwise you can login as
diff --git a/sitemap.xml b/sitemap.xml
index 78c45980..59800a92 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -4,7 +4,7 @@
https://m0ses.github.io/kanku/
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/blog/
@@ -142,379 +142,379 @@
https://m0ses.github.io/kanku/page/about/
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/download/
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/faq/
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/getting_started/
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/overview/
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Dispatch::RabbitMQ.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Handler.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Handler::ChangeDomainState.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Handler::CleanupIPTables.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Handler::CopyProfile.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Handler::CreateDomain.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Handler::DomainSnapshot.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Handler::ExecuteCommandOnHost.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Handler::ExecuteCommandViaConsole.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Handler::ExecuteCommandViaSSH.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Handler::GIT.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Handler::HTTPDownload.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Handler::ImageDownload.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Handler::K8NodePortForward.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Handler::OBSCheck.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Handler::OBSDownload.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Handler::OBSServerFrontendTests.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Handler::OpenStack::CreateInstance.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Handler::OpenStack::Image.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Handler::OpenStack::RemoveInstance.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Handler::PortForward.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Handler::PrepareSSH.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Handler::Reboot.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Handler::RemoveDomain.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Handler::ResizeImage.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Handler::RevertQcow2Snapshot.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Handler::SaltSSH.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Handler::SetJobContext.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Handler::SetupNetwork.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Handler::Wait.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Handler::WaitForSystemd.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::JobList.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Notifier.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Notifier::NSCA.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Notifier::NSCAng.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Notifier::Sendmail.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::NotifyQueue::RabbitMQ.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::RabbitMQ.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Roles::Dispatcher.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Roles::NotifyQueue.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Roles::SSH.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Schema::Result::ImageDownloadHistory.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Schema::Result::JobHistory.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Schema::Result::JobHistorySub.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Schema::Result::JobWaitFor.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Schema::Result::ObsCheckHistory.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Schema::Result::Role.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Schema::Result::User.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Schema::Result::UserRole.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Task.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Task::Local.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Task::Remote.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Task::RemoteAll.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Test::RabbitMQ.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Util.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/Kanku::Util::VM::Console.html
weekly
0.5
- 2024-02-14
+ 2024-02-23
https://m0ses.github.io/kanku/page/pod/OpenStack::API.html
weekly
0.5
- 2024-02-14
+ 2024-02-23