The goal of this tutorial is to walk you through the first run of
your freshly installed SlapOS Slave node.
If you didn't install a SlapOS node, please do so by
tutorial on installing SlapOS.
As a general convention, commands prepended with $ might be run as
ordinary user whereas commands prepended by # require superuser
This tutorial will first explain how to register the server to
Slapos Master community Cloud, then how to run a SlapOS Node, or rather let
it run itself.
Before proceeding further, we need to register your server to
https://slapos.org or https://slapos.vifib.com community Cloud. By doing
so, we will obtain X509 certificate and key which are later needed for
the configuration process.
Go to imtweb.tl.teralab-datascience.fr, register if not already done, go to My Account and click on Generate a Computer Secuity Token:
This section is intended for those who do not have native IPv6 or not
reliable IPv6. We will explain how to use an IPv6 tunnel.
Luckily, IPv6 is increasingly available worldwide thanks to companies
Biglobe. If your
Internet service provider or hosting provider does not provide native
IPv6, simply complain and remind him that 80% of worldwide IPv6 traffic
in 2011 comes from France thanks to innovative companies such
OVH. Strongly complain that due to
their conservatism, they are putting the whole country lagging behind and
prevent innovation to happen in local startup companies. If this is not
sufficient, consider complaining to regulation authorities. No technical
reason justifies the absence of IPv6 nowadays.
If your network does not provide global, routable IPv6 adresses, you
will need to setup an OpenVPN. In order to you have IPv6 everywhere is quite easy
with Re6st Server or OpenVPN server provided by slapos.org:
During your configuration file you are going to select the appropriate IPv6 interface you configured (consider eth0 as your internet interface ):
Run slapos command below, to create the configuration files, when asked please input the Token Saved on Step above.
This command will generate several files at:
Everything is set. It is now time to prepare your computer for
Now run slapos for the the first time for finish configuration:
# slapos node format --alter_user=True --now
It is now time to discuss what to do next with SlapOS now that we
have an idea of its architecture and of the practical installation
process. Experimenting with more machines, in different places of the
world, with different CPU architecture and network is a great source
of innovation. You should also have a look at the tutorial which
explains how to install SlapOS on a USB key. It is much faster and
efficient, but does not teach so well the internals of SlapOS as what
we just did.
If you wish to contribute, to SlapOS and to this tutorial, here
is a list of possible topics. First, this documentation needs peer
review and improved explanations. Seconds, the different approachs to
setup an IPv6 networks needs to be extended. We need good tutorials
to explain how to achieve this in different environments (routable
IPv6, non routable, protocol 41 tunnelling, use of tinc or OpenVPN to
provide IPv6, etc.). And we need more precisions on system
permissions for the different directories of SlapOS. Those are
already defined in the USB Key setup (Kiwi configuration file) but
more documentation is needed.