====== Setup Site Manager Pi ======
A guide to setup the first Raspberry Pi used when [[Building a Site]].

===== Parts & Tools =====

  * 1 Raspberry Pi 5 (or 4)

===== Steps =====

==== Step 1: Generic Pi Setup ====

Prepare a Raspberry Pi using [[Generic Pi Setup]].

==== Step 2: Cloud Init changes ====

Mount the SD card in you computer, and edit the text file named ''user-data''.

Ensure that the packages section looks like the following:

  packages:
  - avahi-daemon
  - docker.io

This adds the docker package (the default version from ubuntu).

Ensure that the hostname is in the following format: ''mbt-X-manager'' where X is replaced with a name used for this Site. For example, a site called makerspace would have the hostname ''mbt-makerspace-manager''. 

==== Step 3: Initialise Docker Swarm ====

While logged in to the manager, run:

  sudo docker swarm init

==== Step 4: Run Swarmpit ====

While logged in to the manager, run:

  sudo docker run -it --rm \
    --name swarmpit-installer \
    --volume /var/run/docker.sock:/var/run/docker.sock \
  swarmpit/install:1.9

When asked for ''stack name'', use the default ''swarmpit'' (just press enter).

When asked for ''application port'', use the default ''888'' (just press enter).

When asked for ''database volume driver'', use the default ''local'' (just press enter).

When asked for ''admin username'', use the default ''admin'' (just press enter).

When asked for ''admin password'', generate a strong password, store it in a password manager, and enter it.

===== Verifying Success =====

The swarmpit UI should be accessible in your browser, at ''http://yourhostname.local:888''.