diff --git a/make_zine6.py b/make_zine6.py
new file mode 100644
index 0000000..8da0b48
--- /dev/null
+++ b/make_zine6.py
@@ -0,0 +1,308 @@
+#!/bin/python
+"""
+A script for generating A5 size pdf zines
+with a text-file input, under development,
+GPL3 Licence, Mara Karagianni May 2021
+"""
+import glob
+import re
+import sys
+import subprocess
+from fpdf import FPDF
+# ref https://pyfpdf.readthedocs.io/en/latest/
+
+# Variables
+header_font = 'helvetica'
+header_font_size = 14
+text_font_size = 12
+
+top_margin = 20
+left_margin = 20
+right_margin = 20
+left_max_margin = 160
+
+max_height = 190
+left_x = 20
+top_y = 30
+cell_width = 110
+cell_header_height = 16
+cell_height = 6
+
+# Image variables
+img_x = 20
+img_y = 80
+img_len = 120
+
+# file to get the text
+if len(sys.argv) > 1:
+    filename = sys.argv[1]
+else:
+    filename = "./notes_sample"
+
+
+class Zine(FPDF):
+
+    def add_new_signature(self, top_margin, left_margin, right_margin):
+        # create new page/signature
+        self.add_page()
+        self.set_margins(left_margin, top_margin, right_margin)
+        self.set_xy(left_margin, top_margin)
+        print('NEW SIGNATURE')
+
+    def move_to_page_right(self, top_margin, left_max_margin, right_margin):
+        print('*****')
+        print("BOTTOM OF LEFT PAGE, height is {}".format(self.get_y()))
+        print('*****')
+        self.set_margins(top_margin, left_max_margin, right_margin)
+        self.set_xy(left_max_margin, top_margin)
+
+    def position_img(self, img_filename, img_x, img_y, **kwargs):
+        img_size = subprocess.run(
+            ["identify", "-format",
+                "%[fx:w/72] by %[fx:h/72] inches",
+                "./%s" % img_filename],
+            stdout=subprocess.PIPE, text=True)
+
+        img_height_inches = img_size.stdout.split(' ')[2]
+        img_width_inches = img_size.stdout.split(' ')[0]
+        img_height_mm = float(img_height_inches) * float(24.5)
+        img_width_mm = float(img_width_inches) * float(24.5)
+
+        if kwargs:
+            max_height = kwargs["max_height"]
+            left_margin = kwargs["left_margin"]
+            top_margin = kwargs["top_margin"]
+
+        if self.get_y() + img_height_mm >= max_height:
+            self.add_page()
+            self.set_xy(left_margin, top_margin)
+            img_y = top_margin
+
+        previous_y = self.get_y()
+        # center image
+        img_x = (150 - img_width_mm) / 2
+        self.image(img_filename, img_x, img_y, img_width_mm)
+
+        # move y at the bottom of the image
+        # TODO check if get_y() would do the same job
+        self.set_xy(self.get_x(), previous_y+img_height_mm)
+
+    def shuffle_chapters(self, pdfinput):
+        subprocess.run(
+            ["pdfseparate", "./%s" % pdfinput, "./%02d_chapter.pdf"],
+            stdout=subprocess.PIPE, text=True)
+        pages = glob.glob("./*_chapter.pdf")
+        pages.sort()
+        print("CHAPTERS {}".format(pages))
+        shuffled_list = []
+        count = 0
+        while count < (len(pages))/2:
+            shuffled_list.append(pages[-(count+1)])
+            shuffled_list.append(pages[count])
+            count += 1
+            # reverse
+            if count != len(pages)/2:
+                shuffled_list.append(pages[count])
+                shuffled_list.append(pages[-(count+1)])
+                count += 1
+        return shuffled_list
+
+    def create_pages(self, filename, max_height, left_margin,
+                     left_max_margin, top_margin, right_margin,
+                     cell_width, cell_height, cell_header_height,
+                     header_font, text_font):
+        chapter = 0
+        lines = open(filename).readlines()
+        print(filename)
+
+        # first page
+        print("FIRST PAGE")
+        self.set_margins(left_margin, top_margin,
+                            right_margin)
+        self.set_xy(left_margin, top_margin)
+        self.add_page()
+
+        for line in lines:
+
+            if ">>" in line:
+                self.set_font(text_font, '', size=16)
+                self.cell(cell_width, cell_height, line,
+                          0, ln=1, align='L')
+                self.set_font(text_font, '', size=text_font_size)
+
+            # check if we have an image
+            elif line.startswith("<img>"):
+                img_filename = line.split("<img>")[1]
+                kwargs = {
+                    "max_height": max_height,
+                    "left_margin": left_margin,
+                    "top_margin": top_margin
+                }
+                self.position_img(
+                    img_filename, self.get_x(), self.get_y(), **kwargs)
+
+            # check if we have a title
+            elif line.startswith("<h2>"):
+                line = re.sub('((<h2>)|(</h2>$))', '', line)
+                self.set_text_color(255, 0, 255)
+                self.set_font(text_font, size=22)
+                if self.get_y() > top_margin:
+                    self.set_xy(left_margin, top_margin+9)
+                    self.add_page()
+                self.cell(cell_width, cell_header_height, line,
+                          0, ln=1, align='C')
+                left_x = self.get_x()
+                top_y = self.get_y()
+                self.dashed_line(
+                    left_x, top_y, left_x+cell_width, top_y,
+                    dash_length=3, space_length=3)
+                self.set_text_color(0, 0, 0)
+                self.set_font(text_font, size=text_font_size)
+
+            elif line.startswith("<b>"):
+                line = re.sub('((<b>)|(</b>$))', '', line)
+                self.set_font(text_font, '', size=18)
+                self.cell(cell_width, cell_height, line,
+                          0, ln=1, align='L')
+                self.set_font(text_font, '', size=text_font_size)
+
+            elif line.startswith("#"):
+                self.set_font('helvetica', 'B', size=9)
+                self.set_text_color(209, 17, 65)
+                self.multi_cell(cell_width, cell_height, line,
+                                0, align='L')
+                # go back to text font
+                self.set_text_color(0, 0, 0)
+                self.set_font(text_font, '', size=text_font_size)
+
+            elif line.startswith("$") or line.startswith("(venv)"):
+                self.set_font('helvetica', 'B', size=9)
+                self.set_text_color(0, 30, 255)
+
+                self.multi_cell(cell_width, cell_height, line,
+                                0, align='L')
+                # go back to text font
+                self.set_text_color(0, 0, 0)
+                self.set_font(text_font, '', size=text_font_size)
+
+            elif line.startswith("<conf>"):
+                #line = re.sub('(<conf>$)', '', line)
+                self.set_font('helvetica', 'B', size=9)
+                self.set_text_color(0,80,115)
+                self.multi_cell(cell_width, cell_height, line,
+                                0, align='L')
+            elif line.startswith("</conf>"):
+                #line = re.sub('(</conf>$)', '', line)
+                self.multi_cell(cell_width, cell_height, line,
+                                0, align='L')
+                self.set_font(text_font, '', text_font_size)
+                self.set_text_color(0, 0, 0)
+
+            elif "<index>" in line:
+                line = re.sub('(<index>$)', '', line)
+                self.set_font(text_font, '', size=18)
+                self.set_text_color(0, 0, 0)
+                self.set_text_color(41, 98, 255)
+                self.cell(cell_width/8, cell_height, line, 0, align='C')
+
+            elif "</index>" in line:
+                line = re.sub('(</index>$)', '', line)
+                self.set_font(text_font, '', size=text_font_size)
+                self.set_text_color(0, 0, 0)
+                self.multi_cell(cell_width, cell_height, line,
+                                0, align='L')
+
+            else:
+                # check if we need the following
+                variable_x = self.get_x()
+                self.multi_cell(cell_width, cell_height, line, 0, align='L')
+                self.set_xy(variable_x, self.get_y())
+
+        self.footer()
+
+    def cover(self, title, cover_font, max_height):
+        col = 10
+        margin = 15
+        import random
+        self.set_margins(margin, margin, margin)
+        self.add_page()
+        for letter in title:
+            if self.get_y() >= max_height:
+                self.set_xy(margin+col, margin)
+                col += 40
+            size = random.randrange(30, 50, 15)
+            self.set_font(cover_font, '', size)
+            variable_x = margin+col
+            print("LETTER {}, POSITION Y {}".format(letter, self.get_y()))
+            print("VAR X {}".format(variable_x))
+            self.set_xy(variable_x, self.get_y())
+
+            self.cell(size, size, letter)
+            self.line(size, size, self.get_x(), self.get_y())
+            if(size % 2 == 0):
+                var = "DF"
+                #r = 138, 43, 226
+                R = random.randrange(30, 255, 40)
+                G = random.randrange(0, 55, 55)
+                B = random.randrange(0, 155, 50)
+                self.set_fill_color(R, G, 255)
+            else:
+                var = "D"
+            print(var)
+            self.rect(
+                float(self.get_x()), float(self.get_y()),
+                float(size/2), float(size*4), style = var)
+            self.ln(size/2)
+
+    def colophon(self, text):
+        lines = open(text, 'r').readlines()
+        top_margin = 20
+        margin = 25
+        self.add_font(
+            'CasaleNBP', '', r"/home/mara/.fonts/CasaletwoNbp-Bp4V.ttf",
+            uni=True)
+        self.set_margins(margin, top_margin, margin)
+        size = 13
+        cover_font = 'CasaleNBP'
+        self.set_font(cover_font, '', size)
+        self.add_page()
+        for line in lines:
+            self.multi_cell(100, size, line, 0, align='C')
+
+    def footer(self):
+        # Go to 1.5 cm from bottom
+        self.set_y(-15)
+        # Select Arial italic 8
+        #self.set_font('Arial', 'I', 8)
+        self.set_text_color(0, 0, 0)
+        self.set_font(text_font, '', size=text_font_size)
+        # Print current and total page numbers
+        self.cell(0, 10, '%s' % self.page_no(), 0, 0, 'C')
+
+
+# set font for all text
+zine = Zine(orientation="P", unit="mm", format="A5")
+
+# cover font
+zine.add_font('CasaleNBP', '', r"/home/mara/.fonts/CasaletwoNbp-Bp4V.ttf", uni=True)
+cover_font = 'CasaleNBP'
+
+# text font
+zine.add_font(
+    'Kpalter', '', r"/home/mara/.fonts/KpProgrammerAlternatesNbp-Zg1q.ttf", uni=True)
+text_font = 'Kpalter'
+zine.set_font(text_font, '', size=text_font_size)
+
+zine.create_pages(filename, max_height, left_margin, left_max_margin,
+                  top_margin, right_margin, cell_width,
+                  cell_height, cell_header_height, header_font, text_font)
+
+pdf = './finals/aug_trial1.pdf'
+zine.output(pdf)
+#chapter_list = zine.shuffle_chapters(pdf)
+#print(chapter_list)
+#subprocess.Popen(["pdfunite"] + chapter_list + ["final_aug.pdf"])
+#zine.cover("deconstruct mailman", cover_font, max_height=140)
+#zine.output("cover.pdf")
+#zine.colophon("./colophon.txt")
+#zine.output("colophon.pdf")
diff --git a/shuffle_pdf.py b/shuffle_pdf.py
new file mode 100644
index 0000000..ab30d2e
--- /dev/null
+++ b/shuffle_pdf.py
@@ -0,0 +1,309 @@
+#!/bin/python
+"""
+A script for generating A5 size pdf zines
+with a text-file input, under development,
+GPL3 Licence, Mara Karagianni May 2021
+"""
+import glob
+import re
+import sys
+import subprocess
+from fpdf import FPDF
+# ref https://pyfpdf.readthedocs.io/en/latest/
+
+# Variables
+header_font = 'helvetica'
+header_font_size = 14
+text_font_size = 12
+
+top_margin = 20
+left_margin = 20
+right_margin = 20
+left_max_margin = 160
+
+max_height = 190
+left_x = 20
+top_y = 30
+cell_width = 110
+cell_header_height = 16
+cell_height = 6
+
+# Image variables
+img_x = 20
+img_y = 80
+img_len = 120
+
+# file to get the text
+if len(sys.argv) > 1:
+    filename = sys.argv[1]
+else:
+    filename = "./notes_sample"
+
+
+class Zine(FPDF):
+
+    def add_new_signature(self, top_margin, left_margin, right_margin):
+        # create new page/signature
+        self.add_page()
+        self.set_margins(left_margin, top_margin, right_margin)
+        self.set_xy(left_margin, top_margin)
+        print('NEW SIGNATURE')
+
+    def move_to_page_right(self, top_margin, left_max_margin, right_margin):
+        print('*****')
+        print("BOTTOM OF LEFT PAGE, height is {}".format(self.get_y()))
+        print('*****')
+        self.set_margins(top_margin, left_max_margin, right_margin)
+        self.set_xy(left_max_margin, top_margin)
+
+    def position_img(self, img_filename, img_x, img_y, **kwargs):
+        img_size = subprocess.run(
+            ["identify", "-format",
+                "%[fx:w/72] by %[fx:h/72] inches",
+                "./%s" % img_filename],
+            stdout=subprocess.PIPE, text=True)
+
+        img_height_inches = img_size.stdout.split(' ')[2]
+        img_width_inches = img_size.stdout.split(' ')[0]
+        img_height_mm = float(img_height_inches) * float(24.5)
+        img_width_mm = float(img_width_inches) * float(24.5)
+
+        if kwargs:
+            max_height = kwargs["max_height"]
+            left_margin = kwargs["left_margin"]
+            top_margin = kwargs["top_margin"]
+
+        if self.get_y() + img_height_mm >= max_height:
+            self.add_page()
+            self.set_xy(left_margin, top_margin)
+            img_y = top_margin
+
+        previous_y = self.get_y()
+        # center image
+        img_x = (150 - img_width_mm) / 2
+        self.image(img_filename, img_x, img_y, img_width_mm)
+
+        # move y at the bottom of the image
+        # TODO check if get_y() would do the same job
+        self.set_xy(self.get_x(), previous_y+img_height_mm)
+
+    def shuffle_chapters(self, pdfinput):
+        subprocess.run(
+            ["pdfseparate", "./%s" % pdfinput, "./%02d_chapter.pdf"],
+            stdout=subprocess.PIPE, text=True)
+        pages = glob.glob("./*_chapter.pdf")
+        pages.sort()
+        print("CHAPTERS {}".format(pages))
+        shuffled_list = []
+        count = 0
+        while count < (len(pages))/2:
+            shuffled_list.append(pages[-(count+1)])
+            shuffled_list.append(pages[count])
+            count += 1
+            # reverse
+            if count != len(pages)/2:
+                shuffled_list.append(pages[count])
+                shuffled_list.append(pages[-(count+1)])
+                count += 1
+        return shuffled_list
+
+    def create_pages(self, filename, max_height, left_margin,
+                     left_max_margin, top_margin, right_margin,
+                     cell_width, cell_height, cell_header_height,
+                     header_font, text_font):
+        chapter = 0
+        lines = open(filename).readlines()
+        print(filename)
+
+        # first page
+        print("FIRST PAGE")
+        self.set_margins(left_margin, top_margin,
+                            right_margin)
+        self.set_xy(left_margin, top_margin)
+        self.add_page()
+
+        for line in lines:
+
+            if ">>" in line:
+                self.set_font(text_font, '', size=16)
+                self.cell(cell_width, cell_height, line,
+                          0, ln=1, align='L')
+                self.set_font(text_font, '', size=text_font_size)
+
+            # check if we have an image
+            elif line.startswith("<img>"):
+                img_filename = line.split("<img>")[1]
+                kwargs = {
+                    "max_height": max_height,
+                    "left_margin": left_margin,
+                    "top_margin": top_margin
+                }
+                self.position_img(
+                    img_filename, self.get_x(), self.get_y(), **kwargs)
+
+            # check if we have a title
+            elif line.startswith("<h2>"):
+                line = re.sub('((<h2>)|(</h2>$))', '', line)
+                self.set_text_color(255, 0, 255)
+                self.set_font(text_font, size=22)
+                if self.get_y() > top_margin:
+                    self.set_xy(left_margin, top_margin+9)
+                    self.add_page()
+                self.cell(cell_width, cell_header_height, line,
+                          0, ln=1, align='C')
+                left_x = self.get_x()
+                top_y = self.get_y()
+                self.dashed_line(
+                    left_x, top_y, left_x+cell_width, top_y,
+                    dash_length=3, space_length=3)
+                self.set_text_color(0, 0, 0)
+                self.set_font(text_font, size=text_font_size)
+
+            elif line.startswith("<b>"):
+                line = re.sub('((<b>)|(</b>$))', '', line)
+                self.set_font(text_font, '', size=18)
+                self.cell(cell_width, cell_height, line,
+                          0, ln=1, align='L')
+                self.set_font(text_font, '', size=text_font_size)
+
+            elif line.startswith("#"):
+                self.set_font('helvetica', 'B', size=9)
+                self.set_text_color(209, 17, 65)
+                self.multi_cell(cell_width, cell_height, line,
+                                0, align='L')
+                # go back to text font
+                self.set_text_color(0, 0, 0)
+                self.set_font(text_font, '', size=text_font_size)
+
+            elif line.startswith("$") or line.startswith("(venv)"):
+                self.set_font('helvetica', 'B', size=9)
+                self.set_text_color(0, 30, 255)
+
+                self.multi_cell(cell_width, cell_height, line,
+                                0, align='L')
+                # go back to text font
+                self.set_text_color(0, 0, 0)
+                self.set_font(text_font, '', size=text_font_size)
+
+            elif line.startswith("<conf>"):
+                #line = re.sub('(<conf>$)', '', line)
+                self.set_font('helvetica', 'B', size=9)
+                self.set_text_color(0,80,115)
+                self.multi_cell(cell_width, cell_height, line,
+                                0, align='L')
+            elif line.startswith("</conf>"):
+                #line = re.sub('(</conf>$)', '', line)
+                self.multi_cell(cell_width, cell_height, line,
+                                0, align='L')
+                self.set_font(text_font, '', text_font_size)
+                self.set_text_color(0, 0, 0)
+
+            elif "<index>" in line:
+                line = re.sub('(<index>$)', '', line)
+                self.set_font(text_font, '', size=18)
+                self.set_text_color(0, 0, 0)
+                self.set_text_color(41, 98, 255)
+                self.cell(cell_width/8, cell_height, line, 0, align='C')
+
+            elif "</index>" in line:
+                line = re.sub('(</index>$)', '', line)
+                self.set_font(text_font, '', size=text_font_size)
+                self.set_text_color(0, 0, 0)
+                self.multi_cell(cell_width, cell_height, line,
+                                0, align='L')
+
+            else:
+                # check if we need the following
+                variable_x = self.get_x()
+                self.multi_cell(cell_width, cell_height, line, 0, align='L')
+                self.set_xy(variable_x, self.get_y())
+
+        self.footer()
+
+    def cover(self, title, cover_font, max_height):
+        col = 10
+        margin = 15
+        import random
+        self.set_margins(margin, margin, margin)
+        self.add_page()
+        for letter in title:
+            if self.get_y() >= max_height:
+                self.set_xy(margin+col, margin)
+                col += 40
+            size = random.randrange(30, 50, 15)
+            self.set_font(cover_font, '', size)
+            variable_x = margin+col
+            print("LETTER {}, POSITION Y {}".format(letter, self.get_y()))
+            print("VAR X {}".format(variable_x))
+            self.set_xy(variable_x, self.get_y())
+
+            self.cell(size, size, letter)
+            self.line(size, size, self.get_x(), self.get_y())
+            if(size % 2 == 0):
+                var = "DF"
+                #r = 138, 43, 226
+                R = random.randrange(30, 255, 40)
+                G = random.randrange(0, 55, 55)
+                B = random.randrange(0, 155, 50)
+                self.set_fill_color(R, G, 255)
+            else:
+                var = "D"
+            print(var)
+            self.rect(
+                float(self.get_x()), float(self.get_y()),
+                float(size/2), float(size*4), style = var)
+            self.ln(size/2)
+
+    def colophon(self, text):
+        lines = open(text, 'r').readlines()
+        top_margin = 20
+        margin = 25
+        self.add_font(
+            'CasaleNBP', '', r"/home/mara/.fonts/CasaletwoNbp-Bp4V.ttf",
+            uni=True)
+        self.set_margins(margin, top_margin, margin)
+        size = 13
+        cover_font = 'CasaleNBP'
+        self.set_font(cover_font, '', size)
+        self.add_page()
+        for line in lines:
+            self.multi_cell(100, size, line, 0, align='C')
+
+    def footer(self):
+        # Go to 1.5 cm from bottom
+        self.set_y(-15)
+        # Select Arial italic 8
+        #self.set_font('Arial', 'I', 8)
+        self.set_text_color(0, 0, 0)
+        self.set_font(text_font, '', size=text_font_size)
+        # Print current and total page numbers
+        self.cell(0, 10, '%s' % self.page_no(), 0, 0, 'C')
+
+
+# set font for all text
+zine = Zine(orientation="P", unit="mm", format="A5")
+
+# cover font
+zine.add_font('CasaleNBP', '', r"/home/mara/.fonts/CasaletwoNbp-Bp4V.ttf", uni=True)
+cover_font = 'CasaleNBP'
+
+# text font
+zine.add_font(
+    'Kpalter', '', r"/home/mara/.fonts/KpProgrammerAlternatesNbp-Zg1q.ttf", uni=True)
+text_font = 'Kpalter'
+zine.set_font(text_font, '', size=text_font_size)
+
+#zine.create_pages(filename, max_height, left_margin, left_max_margin,
+#                  top_margin, right_margin, cell_width,
+#                  cell_height, cell_header_height, header_font, text_font)
+
+#pdf = './finals/aug_trial1.pdf'
+pdf = './finals/final.pdf'
+#zine.output(pdf)
+chapter_list = zine.shuffle_chapters(pdf)
+#print(chapter_list)
+subprocess.Popen(["pdfunite"] + chapter_list + ["final_aug.pdf"])
+#zine.cover("deconstruct mailman", cover_font, max_height=140)
+#zine.output("cover.pdf")
+#zine.colophon("./colophon.txt")
+#zine.output("colophon.pdf")
diff --git a/zine_fixes.txt b/zine_fixes.txt
new file mode 100644
index 0000000..8de9866
--- /dev/null
+++ b/zine_fixes.txt
@@ -0,0 +1,390 @@
+<h2>Introduction</h2>
+
+This tutorial is all about mailman3 software for creating and managing mailing lists and archives. It goes in-depth on how to install mailman3 in a Debian or Ubuntu OS and migrate existing lists from older mailman versions. It assumes that postfix (a Mail Transport Agent, aka  MTA) and mailutils are already installed in the system and configured, and the system can send emails, e.g the root user is sending admin related emails. It also assumes that python3, postgresql and apache2 are installed in the system too. Postfix is one of the possible MTA to be configured with mailman3. Detailed steps for configuring a fresh postfix install and few other MTA options, are included in the CHEAT SHEET note 1.
+The tutorial is intended specifically for sysadmins and users who are curious of how machines and networks work in general.
+Enjoy the geeky reading!
+
+<h2>Install Dependency Libraries</h2>
+
+We enter the remote server and become root user to do system updates:
+$ ssh user@server -i <ssh_key> 
+
+Once we are on the remote server we do the following (as well all the rest of the commands are meant to be ran on the remote server):
+$ sudo su
+
+We give our password and we do the updates:
+# apt update && apt upgrade 
+
+Then we can install some system-wide dependencies:
+# apt-get install build-essential libssl-dev libffi-dev
+
+break down of the above libraries:
+build-essential: GNU debugger, g++/GNU compiler and other tools for compiling software.
+libssl-dev: portion of OpenSSL which supports TLS protocol and depends on libcrypto, a C API.
+libffi-dev: the glue between the interpreter program (python in this case) and the compiled code, for values of arguments to be converted and passed in run-time between the two programs. [Note 3]
+
+Install party goes on:
+# apt install python3-dev python3-venv lynx
+
+break down of the above libraries:
+python3-dev: tools for extending the python interpreter and building python modules.  
+
+python3-venv: a tool to create virtual environment to isolate a python project's dependencies from the OS main python libraries.
+
+lynx: An HTML to plaintext converter like lynx is required by Mailman Core for converting emails to plaintext.
+
+Then install rust from source, which is needed for python Cryptography library later on.
+curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
+Ensure that rust is installed:
+# rust --version 
+
+The above script will also install cargo, which is a package manager, so it fetches any extra dependencies needed for a rustic program, and a builder for rustic programs to be compiled.
+[Note 2] 
+
+We need also sassc: Syntactically Awesome Stylesheets or Sass is an extension of CSS, which allows using variables, nested rules etc. Here we install a C/C++ flavor needed for Hyperkitty archiver that uses sass to generate its CSS styles. https://sass-lang.com/. For the sass installation for debian, download from source and make a symbolic link to /usr/local/bin
+# cd /usr/local/lib [Note 4]
+# wget https://github.com/sass/dart-sass/releases/download/1.32.5/dart-sass-1.32.5-linux-x64.tar.gz
+# tar -xf dart-sass-1.32.5-linux-x64.tar.gz
+# chmod -R 755 dart-sass
+# ln -s /usr/local/lib/dart-sass/sass /usr/local/bin/sass
+# rm -f dart-sass-1.32.5-linux-x64.tar.gz 
+Ref: Note 5
+
+GNU mailman wiki suggests to install also:
+Fail2ban for blocking IP addresses that have too many connection failures.
+# apt install fail2ban
+
+Memcached for Django caches in memory, in order to render mailman's front-end UI faster.
+# apt install memcached
+After installation check that is running at port 11211 with
+# service memcached status 
+
+Output of memcached should show an active status:
+# memcached.service - memcached daemon
+   Loaded: loaded (/lib/systemd/system/memcached.service; enabled; vendor preset: enabled)
+   Active: active (running) since Sun 2021-08-29 15:08:13 EEST; 3h 29min ago
+
+Later we see how to add the CACHES configuration in the mailman settings.py. 
+
+Gettext for supporting internationalization and localization, needed for multilingual environments.
+# apt install gettext
+See configuration settings in CHEAT SHEET [Notes 6, 7, 8]
+
+<h2>System Configurations</h2>
+
+<b>Create a postgresql or mysql database</b>
+Here is an example with postgresql. We replace the names according to our likes and available system paths. Enter the postgresql user and initiate the psql shell (psql command requests the postgres user password which was configured during the postgresql setup). When creating the database, we can opt for setting up a tablespace where the database objects are stored. This is handy when we want to migrate the database because we ran out of disk space. Or when we want to optimize performance. E.g, make use of a fast solid state device (SSD) available as a mounted volume.
+
+# sudo su postgresql
+$ psql 
+> CREATE TABLESPACE mailman_vol LOCATION '/ssd1/postgresql/data';
+> CREATE DATABASE mailman_db OWNER mailman TABLESPACE mailman_vol;
+> exit;
+
+<b>Setup mailman user and virtualenv</b>
+# useradd -m -d /opt/mailman -s /usr/bin/bash mailman
+# sudo su mailman
+Enter mailman directory, create a virtualenv and activate it:
+$ cd ; python3 -m venv venv
+$ source /opt/mailman/venv/bin/activate
+Note: we can add the above command in .bashrc under mailman's home, so every time we enter this user, the virtualenv gets activated automagically.
+
+<b>Install Mailman and other python libraries</b>
+(venv)$ pip install wheel mailman 
+if project connects to a postgresql database then we need also:
+(venv)$ pip install psycopg2-binary
+
+<b>Install front-end UI and archiver</b>
+(venv)$ pip install mailman-web mailman-hyperkitty
+mailman-web provides hyperkitty and postorius which are built atop Django, a Python based web framework. It also provides shortcuts to django admin commands. Later we will create a superuser that has all permissions for administering the lists and can enter the admin area via the browser. 
+
+Install the following for mailman-web application to be able to talk with apache2 server (here we opt for gunicorn, other option is uWSGI) and a python client for Django to connect to memcached:
+(venv)$ pip install gunicorn pylibmc 
+
+<h2>Configurations</h2>
+
+<b>Mailman</b>
+Exit mailman user and as root we create a new dir:
+# mkdir -p /etc/mailman3/ 
+We make owner of this directory the mailman user:
+# chown -R mailman:mailman /etc/mailman3
+and under it, we create the files mailman.cfg and settings.py. 
+Under /opt/mailman/mm we create the file mailman-hyperkitty.cfg ('mm' or other name of our choice, it is a new directory to park hyperkitty configuration and logs).
+In the mailman.cfg edit the archiver directive as following:
+<conf>
+[archiver.hyperkitty]
+class: mailman_hyperkitty.Archiver
+enable: yes
+configuration: /opt/mailman/mm/mailman-hyperkitty.cfg
+</conf>
+In mailman-hyperkitty.cfg add the base url of the archives as localhost, and the shared API key, which must be identical to the value in the /etc/mailman3/settings.py 
+<conf>
+base_url: http://localhost/archives
+api_key: SecretArchiverAPIKey
+</conf>
+For a settings.py sample see in the CHEAT SHEET. The important setting to add, which allows automated correspondence from the site manager: 
+<conf>
+DEFAULT_FROM_EMAIL = 'lists@sdomain-name.org' or 'user@localhost'
+</conf>
+And for activating the memcached we need to add:
+<conf>
+'default': {
+    'BACKEND': 'django.core.cache.backends.memcached.MemcachedCache',
+     'LOCATION': os.environ.get('CACHE_LOCATION','127.0.0.1:11211'),
+    }
+}
+</conf>
+Note 1: django's global settings is located in /opt/mailman/venv/lib/python3.7/site-packages/django/conf/global_settings.py. These are imported in the /etc/mailman3/settings.py and they get overwritten if declared again in the latter file.
+Note 2: If we want to use an external mail service than the localhost, we need also to set:
+<conf>
+EMAIL_HOST = <third-party provider>
+EMAIL_PORT = 25
+EMAIL_HOST_USER = <username>
+EMAIL_HOST_PASSWORD = <password>
+Extra options to set in case they are needed:
+EMAIL_TIMEOUT = <time in secs>
+EMAIL_USE_TLS = True
+OR
+EMAIL_USE_SSL = True
+</conf>
+See Note 9, and an example with gmail see note 10.
+If we use local postfix email configuration, then the default values in global_settings for localhost are fine. 
+
+<b>Postfix configuration</b>
+Check open ports in the system. Look if the smtpd port 25 is open. Postfix is the MTA which will relay incoming and outgoing mails to mailman. [Note 11]
+sudo ss -tulpn | grep smtpd
+ 
+if postfix is already installed, edit the /etc/postfix/main.cf:
+<conf>
+inet_interfaces = all
+myhostname = server_hostname
+mydestination = $myhostname, localhost.$myhostname, localhost
+inet_protocols = all
+unknown_local_recipient_reject_code = 550
+owner_request_special = no
+always_add_missing_headers = yes
+transport_maps =
+    hash:/opt/mailman/mm/var/data/postfix_lmtp
+local_recipient_maps =
+    hash:/opt/mailman/mm/var/data/postfix_lmtp
+relay_domains =
+    hash:/opt/mailman/mm/var/data/postfix_domains
+default_destination_recipient_limit = 30
+default_destination_concurrency_limit = 15
+header_checks = regexp:/etc/postfix/header_checks
+</conf>
+Save and close the file.
+If we need to install and configure postfix, see note 12.
+
+Now that most of configuration is done, we populate the mailman_db table with the postorius and hyperkitty fields. To do so in django, we run the infamous migrations.
+Enter mailman user again
+# sudo su mailman
+(venv) $ cd
+(venv) $ mailman-web generate_secret_key
+
+Add the value from the above in the /etc/mailman3/settings.py SECRET_KEY
+(venv)$ mailman-web migrate
+
+collect static files for the mailman-web 
+(venv)$ mailman-web collectstatic
+
+and create a django admin superuser
+(venv)$ mailman-web createsuperuser
+ 
+
+<b>Run mailman-web locally</b>
+(venv) $ pip install Werkzeug
+(venv) $ mailman-web runserver_plus
+
+If django runs locally with the above command, we now try and run it with gunicorn
+(venv) $ gunicorn -c /opt/mailman/gunicorn.py mailman_web.wsgi:application
+
+This runs the django application and listens to port 8000
+An example of gunicorn.py:
+#!/opt/mailman/venv/bin/python
+
+import sys
+sys.path[0:0] = [
+  '/opt/mailman/',
+  '/etc/mailman3/'
+  ]
+
+import os
+os.environ['DJANGO_SETTINGS_MODULE'] = 'settings'
+
+import gunicorn.app.wsgiapp
+
+if __name__ == '__main__':
+    sys.exit(gunicorn.app.wsgiapp.run())
+
+[Notes 13, 14, 15]
+If we opt for uWSGI instead of gunicorn see note 16.
+
+<h2>Automate mailman and schedule jobs</h2>
+
+<b>System services</b>
+Run as daemon the above gunicorn (or uwsgi) command by adding it as service to persist reboots.
+As root:
+# vi /lib/systemd/system/gunicorn.service
+
+the ExecStart command should match the command above when we ran the server locally, but we give the full path to the venv gunicorn executable:
+[Unit]
+Description=GNU Mailman web interfaces
+After=network-online.target firewalld.service
+Wants=network-online.target
+
+[Service]
+PIDFile=/opt/mailman/mm/var/gunicorn.pid
+WorkingDirectory=/opt/mailman/
+ExecStart=/opt/mailman/venv/bin/gunicorn -c /opt/mailman/gunicorn.py mailman_web.wsgi:application
+ExecReload=/bin/kill -s HUP $MAINPID
+ExecStop=/bin/kill -s QUIT $MAINPID
+PrivateTmp=true
+# Change to a different user (and group) here
+User=mailman
+Group=mailman
+Restart=always
+
+[Install]
+WantedBy=multi-user.target
+
+For Qcluster
+# vi /lib/systemd/system/qcluster.service
+sample:
+[Unit]
+Description=HyperKitty async tasks runner
+After=network-online.target remote-fs.target
+
+[Service]
+ExecStart=/opt/mailman/venv/bin/mailman-web qcluster
+User=mailman
+Restart=always
+
+[Install]
+WantedBy=multi-user.target
+
+For Mailman core
+# vi /lib/systemd/system/mailman3.service
+See sample at note 17
+
+Then we reload the services and check their status
+# systemctl daemon-reload
+# systemctl status mailman3
+same for gunicorn and qcluster
+
+<b>Cron jobs</b>
+As mailman user
+(venv) $ crontab -e
+@hourly  /opt/mailman/mm/bin/django-admin runjobs hourly
+@daily   /opt/mailman/mm/bin/django-admin runjobs daily
+@weekly  /opt/mailman/mm/bin/django-admin runjobs weekly
+@monthly /opt/mailman/mm/bin/django-admin runjobs monthly
+@yearly  /opt/mailman/mm/bin/django-admin runjobs yearly
+0,15,30,45 * * * * /opt/mailman/mm/bin/django-admin runjobs quarter_hourly
+* * * * * /opt/mailman/mm/bin/django-admin runjobs minutely
+
+# Send periodic digests.
+30 3 * * * /opt/mailman/mm/bin/mailman digests --periodic
+
+# Send request reminder for MM 3. Like the checkdbs job for 2.1
+0 8 * * * /opt/mailman/mm/bin/mailman notify
+
+<b>Apache</b> 
+Go to /etc/apache2/sites-available and create new configuration for the domain name of our lists. Check if proxy_http is enabled and use it for the localhost mailman-web application. See sample at note 18.
+
+<h2>Migrate lists</h2>
+
+Copy existing list from old to new server.
+create ssh keys for old server where existing lists reside.
+Copy public ssh key to new server's mailman user.
+Make sure to create dir /opt/mailman/.ssh. To copy ssh keys securely see note 19.
+It needs ssh password authentication on at /etc/ssh/sshd_config. Turn it off after copying the public key.
+
+A new tmp dir in the new server, under mailman will be the target for copying the existing lists and archives.
+We use rsync to copy the lists from within the old server. 
+rsync -avz ssh /var/lib/mailman/lists mailman@<new-server>:~/tmp/
+rsync -avz ssh /var/lib/mailman/archives mailman@<new-server>:~/tmp
+[Note 20]
+
+<b>Import old lists</b>
+From new server, enter mailman user again.
+(venv) $ mailman create foo-list@<new-lists-domain>
+(venv) $ mailman import21 foo-list@<new-lists-domain> ~/tmp/lists/foo-list/config.pck
+(venv) $ python manage.py hyperkitty_import -l foo-list@<new-lists-domain> ~/tmp/archives/private/<list>.mbox/<list>.mbox
+(venv) $ mailman-web update_index_one_list foo-list@<new-lists-domain>
+[Note 21]
+
+<h2>Troubleshooting</h2>
+
+1. Domain name shows as example.com
+First we need to login at the web front-end with the superuser credentials we created before. Then we create a domain for our site from url <lists-domain>/mailman3/domains/
+We copy the site_id number and edit the mailman3/settings.py accordingly.
+We restart gunicorn + apache2 service. Test by creating a new list from web front-end at <lists-domain>/mailman3/lists/. [Note 22]
+
+2. mailman web command that shows a bunch of cool actions
+$ mailman-web help 
+
+3. sass bin executable symbolic link didn't work until I set the right permissions rwxr-xr-x on the dart-sass/sass binary
+
+4. In the /etc/mailman/mm/mailman-hyperkiitty.cfg file add:
+base_url: http://localhost:8000/archives/
+If you chose other uri for the archives, modify respectively. It should match with the url in apache2 configuration. See below an apache2 sample.
+Also add in mailman-hyperkiitty.cfg the same "api_key" as in the /etc/mailman3/settings.py 
+
+5. outgoing mail not sent! It can drive you nuts. Reading AGAIN the mailman's project postfix configuration. In the mailman.cfg, the "lmtp_post" should be the domain name or, 127.0.0.1 if all components are found in the same server.
+*** localhost has to be numeric, or postfix doesn't recognize it!
+Also add the lists domain name in "MAILMAN_ARCHIVER_FROM" in the /etc/mailman3/settings.py. Note 23
+ 
+6. Static files not served with apache2 and proxy_http
+Place "ProxyPass /static/ !" should come first in the apache2 server configuration, before the proxies to the localhost:8000 urls. 
+[Note 24]
+
+<h2>CHEAT SHEET</h2>
+
+1. Mail Transport Agent options:
+https://mailman.readthedocs.io/en/latest/src/mailman/docs/mta.html     
+2. https://doc.rust-lang.org/cargo/guide/why-cargo-exists.html
+3. About libfii https://sourceware.org/libffi/
+4. sass 
+5. https://docs.mailman3.org/en/latest/install/virtualenv.html#installing-dependencies
+6. GNU mailman3 wiki https://wiki.list.org/DOC/Howto_Install_Mailman3_On_Debian10
+
+7. fail2ban configure settings https://www.howtogeek.com/675010/how-to-secure-your-linux-computer-with-fail2ban/ 
+8. Gettext https://www.gnu.org/software/gettext/manual/html_node/Concepts.html#Concepts
+9. Email settings for django
+https://docs.djangoproject.com/en/3.0/ref/settings/?ref=hackernoon.com#email-use-tls
+
+10. Example with gmail setup for django:
+https://www.geekinsta.com/send-email-from-django-using-gmail-smtp/
+11. Mail server ports
+https://serverfault.com/questions/149903/what-ports-to-open-for-mail-server
+https://vitux.com/find-open-ports-on-debian/
+
+12. Postfix install and configuration
+https://docs.mailman3.org/en/latest/install/virtualenv.html#setup-mta
+
+13. Mailman django migrations https://docs.mailman3.org/en/latest/install/virtualenv.html#run-database-migrations
+
+14. Extra options for setting up the django mailman_web
+https://docs.mailman3.org/en/latest/install/virtualenv.html
+
+15. Gunicorn installation and guide
+https://docs.gunicorn.org/en/stable/
+
+16. Setting up with uWSGI https://docs.mailman3.org/en/latest/install/virtualenv.html#setting-up-a-wsgi-server
+
+17. Mailman service https://docs.mailman3.org/en/latest/install/virtualenv.html#starting-mailman-automatically
+18. Apache2 + gunicorn
+https://djangodeployment.readthedocs.io/en/latest/05-static-files.html?highlight=apache2#setting-up-apache 
+19. https://www.simplified.guide/ssh/copy-public-key 
+20. rsync docs
+21. Mailman import commands https://docs.mailman3.org/en/latest/migration.html#upgrade-strategy 
+22. https://docs.mailman3.org/en/latest/faq.html#the-domain-name-displayed-in-hyperkitty-shows-example-com-or-something-else
+
+23.https://docs.mailman3.org/projects/mailman/en/latest/src/mailman/docs/mta.html
+24. ProxyPass troubleshooting
+/https://stackoverflow.com/questions/50621464/deploy-django-static-files-with-apache-
+gunicorn
+25. mailman commands
+https://docs.mailman3.org/projects/mailman/en/latest/src/mailman/commands/docs/commands.html
+
diff --git a/zine_utf8.txt b/zine_utf8.txt
new file mode 100644
index 0000000..eb13a9a
--- /dev/null
+++ b/zine_utf8.txt
@@ -0,0 +1,398 @@
+Introduction
+
+This tutorial is all about mailman3 software for creating and managing mailing lists and archives. It goes in-depth on how to install mailman3 in a Debian or Ubuntu OS and migrate existing lists from older mailman versions. It assumes that postfix (a Mail Transport Agent, aka  MTA) and mailutils are already installed in the system and configured, and the system can send emails, e.g the root user is sending admin related emails. It also assumes that python3, postgresql and apache2 are installed in the system too. Postfix is one of the possible MTA to be configured with mailman3. Detailed steps for configuring a fresh postfix install and few other MTA options, are included in the CHEAT SHEET note 1. The tutorial is intended specifically for sysadmins and users who are curious of how machines and networks work in general.
+Enjoy the geeky reading!
+
+<h2>Install Dependency Libraries</h2>
+
+We enter the remote server and become root user to do system updates:
+$ ssh user@server -i <ssh_key> 
+
+Once we are on the remote server we do the following (as well all the rest of the commands are meant to be ran on the remote server):
+$ sudo su
+
+We give our password and we do the updates:
+# apt update && apt upgrade 
+
+Then we can install some system-wide dependencies:
+# apt-get install build-essential libssl-dev libffi-dev
+
+break down of the above libraries:
+build-essential: GNU debugger, g++/GNU compiler and other tools for compiling software.
+libssl-dev: portion of OpenSSL which supports TLS protocol and depends on libcrypto, a C API.
+libffi-dev: the glue between the interpreter program (python in this case) and the compiled code, for values of arguments to be converted and passed in run-time between the two programs. [Note 3]
+
+Install party goes on:
+# apt install python3-dev python3-venv lynx
+
+break down of the above libraries:
+python3-dev: tools for extending the python interpreter and building python modules.  
+
+python3-venv: a tool to create virtual environment to isolate a python project's dependencies from the OS main python libraries.
+
+lynx: An HTML to plaintext converter like lynx is required by Mailman Core for converting emails to plaintext.
+
+Then install rust from source, which is needed for python Cryptography library later on.
+curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
+Ensure that rust is installed:
+# rust --version 
+
+The above script will also install cargo, which is a package manager, so it fetches any extra dependencies needed for a rustic program, and a builder for rustic programs to be compiled.
+[Note 2] 
+
+We need also sassc: Syntactically Awesome Stylesheets or Sass is an extension of CSS, which allows using variables, nested rules etc. Here we install a C/C++ flavor needed for Hyperkitty archiver that uses sass to generate its CSS styles. https://sass-lang.com/. For the sass installation for debian, download from source and make a symbolic link to /usr/local/bin
+# cd /usr/local/lib [Note 4]
+# wget https://github.com/sass/dart-sass/releases/download/1.32.5/dart-sass-1.32.5-linux-x64.tar.gz
+# tar -xf dart-sass-1.32.5-linux-x64.tar.gz
+# chmod -R 755 dart-sass
+# ln -s /usr/local/lib/dart-sass/sass /usr/local/bin/sass
+# rm -f dart-sass-1.32.5-linux-x64.tar.gz 
+Ref: Note 5
+
+GNU mailman wiki suggests to install also:
+Fail2ban for blocking IP addresses that have too many connection failures.
+# apt install fail2ban
+
+Memcached for Django caches in memory, in order to render mailman's front-end UI faster.
+# apt install memcached
+After installation check that is running at port 11211 with
+# service memcached status 
+
+Output of memcached should show an active status:
+# memcached.service - memcached daemon
+   Loaded: loaded (/lib/systemd/system/memcached.service; enabled; vendor preset: enabled)
+   Active: active (running) since Sun 2021-08-29 15:08:13 EEST; 3h 29min ago
+
+Later we see how to add the CACHES configuration in the mailman settings.py. 
+
+Gettext for supporting internationalization and localization, needed for multilingual environments.
+# apt install gettext
+See configuration settings in CHEAT SHEET [Notes 6, 7, 8]
+
+<h2>System Configurations</h2>
+
+<b>Create a postgresql or mysql database</b>
+Here is an example with postgresql. We replace the names according to our likes and available system paths. Enter the postgresql user and initiate the psql shell (psql command requests the postgres user password which was configured during the postgresql setup). When creating the database, we can opt for setting up a tablespace where the database objects are stored. This is handy when we want to migrate the database because we ran out of disk space. Or when we want to optimize performance. E.g, make use of a fast solid state device (SSD) available as a mounted volume.
+
+# sudo su postgresql
+$ psql 
+
+> CREATE TABLESPACE mailman_vol LOCATION '/ssd1/postgresql/data';
+> CREATE DATABASE mailman_db OWNER mailman TABLESPACE mailman_vol;
+> exit;
+<b>Setup mailman user and virtualenv</b>
+# useradd -m -d /opt/mailman -s /usr/bin/bash mailman
+# sudo su mailman
+Enter mailman directory, create a virtualenv and activate it:
+$ cd ; python3 -m venv venv
+$ source /opt/mailman/venv/bin/activate
+Note: we can add the above command in .bashrc under mailman's home, so every time we enter this user, the virtualenv gets activated automagically.
+
+<b>Install Mailman and other python libraries</b>
+(venv)$ pip install wheel mailman 
+if project connects to a postgresql database then we need also:
+(venv)$ pip install psycopg2-binary
+
+<b>Install front-end UI and archiver</b>
+(venv)$ pip install mailman-web mailman-hyperkitty
+mailman-web provides hyperkitty and postorius which are built atop Django, a Python based web framework. It also provides shortcuts to django admin commands. Later we will create a superuser that has all permissions for administering the lists and can enter the admin area via the browser. 
+
+Install the following for mailman-web application to be able to talk with apache2 server (here we opt for gunicorn, other option is uWSGI) and a python client for Django to connect to memcached:
+(venv)$ pip install gunicorn pylibmc 
+
+<h2>Configurations</h2>
+<b>Mailman</b>
+Exit mailman user and as root we create a new dir:
+# mkdir -p /etc/mailman3/ 
+
+We make owner of this directory the mailman user:
+# chown -R mailman:mailman /etc/mailman3
+
+and under it, we create the files mailman.cfg and settings.py. 
+Under /opt/mailman/mm we create the file mailman-hyperkitty.cfg ('mm' or other name of our choice, it is a new directory to park hyperkitty configuration and logs).
+
+In the mailman.cfg edit the archiver directive as following:
+<code>
+[archiver.hyperkitty]
+class: mailman_hyperkitty.Archiver
+enable: yes
+configuration: /opt/mailman/mm/mailman-hyperkitty.cfg
+</code>
+
+And in mailman-hyperkitty.cfg:
+<code>
+# The base_url should correspond with the apache2 links we configure later
+base_url: http://localhost/archives
+
+# Shared API key, must be the identical to the value the same as in the /etc/mailman3/settings.py 
+api_key: SecretArchiverAPIKey
+</code>
+
+For a settings.py sample see in the CHEAT SHEET. The important setting to add, which allows automated correspondence from the site manager: 
+DEFAULT_FROM_EMAIL = 'lists@sdomain-name.org' or 'user@localhost'
+
+And for activating the memcached we need to add:
+'default': {
+    'BACKEND': 'django.core.cache.backends.memcached.MemcachedCache',
+     'LOCATION': os.environ.get('CACHE_LOCATION','127.0.0.1:11211'),
+    }
+}
+ 
+Note 1: django's global settings is located in /opt/mailman/venv/lib/python3.7/site-packages/django/conf/global_settings.py. These are imported in the /etc/mailman3/settings.py and they get overwritten if declared again in the latter file.
+
+Note 2: If we want to use an external mail service than the localhost, we need also to set:
+EMAIL_HOST = <third-party provider>
+EMAIL_PORT = 25
+EMAIL_HOST_USER = <username>
+EMAIL_HOST_PASSWORD = <password>
+Extra options to set in case they are needed:
+EMAIL_TIMEOUT = <time in secs>
+EMAIL_USE_TLS = True
+OR
+EMAIL_USE_SSL = True
+
+See Note 9, and an example with gmail see note 10.
+
+If we use local postfix email configuration, then the default values in global_settings for localhost are fine. 
+
+<b>Postfix configuration</b>
+Check open ports in the system. Look if the smtpd port 25 is open. Postfix is the MTA which will relay incoming and outgoing mails to mailman. [Note 11]
+sudo ss -tulpn | grep smtpd
+ 
+if postfix is already installed, edit the /etc/postfix/main.cf:
+<code>
+inet_interfaces = all
+myhostname = server_hostname
+mydestination = $myhostname, localhost.$myhostname, localhost
+inet_protocols = all
+unknown_local_recipient_reject_code = 550
+owner_request_special = no
+always_add_missing_headers = yes
+transport_maps =
+    hash:/opt/mailman/mm/var/data/postfix_lmtp
+local_recipient_maps =
+    hash:/opt/mailman/mm/var/data/postfix_lmtp
+relay_domains =
+    hash:/opt/mailman/mm/var/data/postfix_domains
+default_destination_recipient_limit = 30
+default_destination_concurrency_limit = 15
+
+header_checks = regexp:/etc/postfix/header_checks
+</code>
+Save and close the file.
+If we need to install and configure postfix, see note 12.
+
+Now that most of configuration is done, we populate the mailman_db table with the postorius and hyperkitty fields. To do so in django, we run the infamous migrations.
+Enter mailman user again
+# sudo su mailman
+(venv) $ cd
+(venv) $ mailman-web generate_secret_key
+
+Add the value from the above in the /etc/mailman3/settings.py SECRET_KEY
+(venv)$ mailman-web migrate
+
+collect static files for the mailman-web 
+(venv)$ mailman-web collectstatic
+
+and create a django admin superuser
+(venv)$ mailman-web createsuperuser
+ 
+<b>Run mailman-web locally</b>
+(venv) $ pip install Werkzeug
+(venv) $ mailman-web runserver_plus
+
+If django runs locally with the above command, we now try and run it with gunicorn
+(venv) $ gunicorn -c /opt/mailman/gunicorn.py mailman_web.wsgi:application
+
+This runs the django application and listens to port 8000
+An example of gunicorn.py:
+#!/opt/mailman/venv/bin/python
+
+import sys
+sys.path[0:0] = [
+  '/opt/mailman/',
+  '/etc/mailman3/'
+  ]
+
+import os
+os.environ['DJANGO_SETTINGS_MODULE'] = 'settings'
+
+import gunicorn.app.wsgiapp
+
+if __name__ == '__main__':
+    sys.exit(gunicorn.app.wsgiapp.run())
+
+[Notes 13, 14, 15]
+If we opt for uWSGI instead of gunicorn see note 16.
+
+<h2>Automate mailman and schedule jobs</h2>
+
+<b>System services</b>
+Run as daemon the above gunicorn (or uwsgi) command by adding it as service to persist reboots.
+As root:
+# vi /lib/systemd/system/gunicorn.service
+
+the ExecStart command should match the command above when we ran the server locally, but we give the full path to the venv gunicorn executable:
+[Unit]
+Description=GNU Mailman web interfaces
+After=network-online.target firewalld.service
+Wants=network-online.target
+
+[Service]
+PIDFile=/opt/mailman/mm/var/gunicorn.pid
+WorkingDirectory=/opt/mailman/
+ExecStart=/opt/mailman/venv/bin/gunicorn -c /opt/mailman/gunicorn.py mailman_web.wsgi:application
+ExecReload=/bin/kill -s HUP $MAINPID
+ExecStop=/bin/kill -s QUIT $MAINPID
+PrivateTmp=true
+# Change to a different user (and group) here
+User=mailman
+Group=mailman
+Restart=always
+
+[Install]
+WantedBy=multi-user.target
+
+For Qcluster
+# vi /lib/systemd/system/qcluster.service
+sample:
+[Unit]
+Description=HyperKitty async tasks runner
+After=network-online.target remote-fs.target
+
+[Service]
+ExecStart=/opt/mailman/venv/bin/mailman-web qcluster
+User=mailman
+Restart=always
+
+[Install]
+WantedBy=multi-user.target
+
+For Mailman core
+# vi /lib/systemd/system/mailman3.service
+See sample at note 17
+
+Then we reload the services and check their status
+# systemctl daemon-reload
+# systemctl status mailman3
+same for gunicorn and qcluster
+
+<b>Cron jobs</b>
+As mailman user
+(venv) $ crontab -e
+@hourly  /opt/mailman/mm/bin/django-admin runjobs hourly
+@daily   /opt/mailman/mm/bin/django-admin runjobs daily
+@weekly  /opt/mailman/mm/bin/django-admin runjobs weekly
+@monthly /opt/mailman/mm/bin/django-admin runjobs monthly
+@yearly  /opt/mailman/mm/bin/django-admin runjobs yearly
+0,15,30,45 * * * * /opt/mailman/mm/bin/django-admin runjobs quarter_hourly
+* * * * * /opt/mailman/mm/bin/django-admin runjobs minutely
+
+# Send periodic digests.
+30 3 * * * /opt/mailman/mm/bin/mailman digests --periodic
+
+# Send request reminder for MM 3. Like the checkdbs job for 2.1
+0 8 * * * /opt/mailman/mm/bin/mailman notify
+
+<b>Apache2</b> 
+Go to /etc/apache2/sites-available and create new configuration for the domain name of our lists. Check if proxy_http is enabled and use it for the localhost mailman-web application. See sample at note 18.
+
+<h2>Migrate lists</h2>
+
+Copy existing list from old to new server.
+create ssh keys for old server where existing lists reside.
+Copy public ssh key to new server's mailman user.
+Make sure to create dir /opt/mailman/.ssh. To copy ssh keys securely see note 19.
+It needs ssh password authentication on at /etc/ssh/sshd_config. Turn it off after copying the public key.
+
+A new tmp dir in the new server, under mailman will be the target for copying the existing lists and archives.
+We use rsync to copy the lists from within the old server. 
+rsync -avz ssh /var/lib/mailman/lists mailman@<new-server>:~/tmp/
+rsync -avz ssh /var/lib/mailman/archives mailman@<new-server>:~/tmp
+[Note 20]
+
+<b>Import old lists</b>
+From new server, enter mailman user again.
+(venv) $ mailman create foo-list@<new-lists-domain>
+(venv) $ mailman import21 foo-list@<new-lists-domain> ~/tmp/lists/foo-list/config.pck
+(venv) $ python manage.py hyperkitty_import -l foo-list@<new-lists-domain> ~/tmp/archives/private/<list>.mbox/<list>.mbox
+(venv) $ mailman-web update_index_one_list foo-list@<new-lists-domain>
+[Note 21]
+
+<h2>Troubleshooting</h2>
+
+1. Domain name shows as example.com
+First we need to login at the web front-end with the superuser credentials we created before. Then we create a domain for our site from url <lists-domain>/mailman3/domains/
+We copy the site_id number and edit the mailman3/settings.py accordingly.
+We restart gunicorn + apache2 service. Test by creating a new list from web front-end at <lists-domain>/mailman3/lists/. 
+[Note 22]
+
+2. mailman web command that shows a bunch of cool actions
+$ mailman-web help 
+
+3. sass bin executable symbolic link didn't work until I set the right permissions rwxr-xr-x on the dart-sass/sass binary
+
+4. In the /etc/mailman/mm/mailman-hyperkiitty.cfg file add:
+base_url: http://localhost:8000/archives/
+
+If you chose other uri for the archives, modify respectively. It should match with the url in apache2 configuration. See below a apache2 sample.
+Also add in mailman-hyperkiitty.cfg the same "api_key" as in the /etc/mailman3/settings.py 
+
+5. outgoing mail not sent! It can drive you nuts. Reading AGAIN the mailman's project postfix configuration. In the mailman.cfg, the "lmtp_post" should be the domain name or, 127.0.0.1 if all components are found in the same server.
+*** localhost has to be numeric, or postfix doesn't recognize it!
+
+Also add the lists domain name in "MAILMAN_ARCHIVER_FROM" in the /etc/mailman3/settings.py. Note 23
+ 
+6. Static files not served with apache2 and proxy_http
+Place "ProxyPass /static/ !" should come first in the apache2 server configuration, before the proxies to the localhost:8000 urls. 
+[Note 24]
+
+<h2>CHEAT SHEET</h2>
+
+1. Mail Transport Agent options:
+https://mailman.readthedocs.io/en/latest/src/mailman/docs/mta.html     
+2. https://doc.rust-lang.org/cargo/guide/why-cargo-exists.html
+3. About libfii https://sourceware.org/libffi/
+4. sass 
+5. https://docs.mailman3.org/en/latest/install/virtualenv.html#installing-dependencies
+6. GNU mailman3 wiki https://wiki.list.org/DOC/Howto_Install_Mailman3_On_Debian10
+
+7. fail2ban configure settings https://www.howtogeek.com/675010/how-to-secure-your-linux-computer-with-fail2ban/ 
+8. Gettext https://www.gnu.org/software/gettext/manual/html_node/Concepts.html#Concepts
+9. Email settings for django
+https://docs.djangoproject.com/en/3.0/ref/settings/?ref=hackernoon.com#email-use-tls
+
+10. Example with gmail setup for django:
+https://www.geekinsta.com/send-email-from-django-using-gmail-smtp/
+11. Mail server ports
+https://serverfault.com/questions/149903/what-ports-to-open-for-mail-server
+https://vitux.com/find-open-ports-on-debian/
+
+12. Postfix install and configuration
+https://docs.mailman3.org/en/latest/install/virtualenv.html#setup-mta
+
+13. Mailman django migrations https://docs.mailman3.org/en/latest/install/virtualenv.html#run-database-migrations
+
+14. Extra options for setting up the django mailman_web
+https://docs.mailman3.org/en/latest/install/virtualenv.html
+
+15. Gunicorn installation and guide
+https://docs.gunicorn.org/en/stable/
+
+16. Setting up with uWSGI https://docs.mailman3.org/en/latest/install/virtualenv.html#setting-up-a-wsgi-server
+
+17. Mailman service https://docs.mailman3.org/en/latest/install/virtualenv.html#starting-mailman-automatically
+18. Apache2 + gunicorn
+https://djangodeployment.readthedocs.io/en/latest/05-static-files.html?highlight=apache2#setting-up-apache 
+19. https://www.simplified.guide/ssh/copy-public-key 
+20. rsync docs
+21. Mailman import commands https://docs.mailman3.org/en/latest/migration.html#upgrade-strategy 
+22. https://docs.mailman3.org/en/latest/faq.html#the-domain-name-displayed-in-hyperkitty-shows-example-com-or-something-else
+
+23.https://docs.mailman3.org/projects/mailman/en/latest/src/mailman/docs/mta.html
+24. ProxyPass troubleshooting
+/https://stackoverflow.com/questions/50621464/deploy-django-static-files-with-apache-
+gunicorn
+25. mailman commands
+https://docs.mailman3.org/projects/mailman/en/latest/src/mailman/commands/docs/commands.html
+