FeministWiki:Server setup: Difference between revisions

    From FeministWiki
    mNo edit summary
    Line 7: Line 7:
    First of all, let's make sure the system is up to date.
    First of all, let's make sure the system is up to date.


      apt-get update
    apt-get update
      apt-get upgrade
    apt-get upgrade
      apt-get dist-upgrade
    apt-get dist-upgrade


    === Install miscellaneous tools ===
    === Install miscellaneous tools ===
    Line 15: Line 15:
    Some of these are needed further down, some are just good to have.
    Some of these are needed further down, some are just good to have.


      apt-get install certbot
    apt-get install certbot
      apt-get install dnsutils
    apt-get install dnsutils
      apt-get install git
    apt-get install git
      apt-get install mg
    apt-get install mg
      apt-get install moreutils
    apt-get install moreutils
      apt-get install net-tools
    apt-get install net-tools
      apt-get install nmap
    apt-get install nmap
      apt-get install software-properties-common
    apt-get install software-properties-common
      apt-get install tree
    apt-get install tree


    === Set up firewall ===
    === Set up firewall ===
    Line 29: Line 29:
    For now, block everything but SSH.
    For now, block everything but SSH.


      apt-get install ufw
    apt-get install ufw
      ufw allow proto tcp to 0.0.0.0/0 port 22
    ufw allow proto tcp to 0.0.0.0/0 port 22
      ufw enable
    ufw enable


    === Install server components ===
    === Install server components ===
    Line 39: Line 39:
    Backports:
    Backports:


      echo deb http://deb.debian.org/debian $(lsb_release -sc)-backports main > /etc/apt/sources.list.d/backports.list
    echo deb http://deb.debian.org/debian $(lsb_release -sc)-backports main > /etc/apt/sources.list.d/backports.list


    PHP repo '''only''' if a very new version is needed:
    PHP repo '''only''' if a very new version is needed:


      wget -O /etc/apt/trusted.gpg.d/sury-php.gpg https://packages.sury.org/php/apt.gpg
    wget -O /etc/apt/trusted.gpg.d/sury-php.gpg https://packages.sury.org/php/apt.gpg
      echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" > /etc/apt/sources.list.d/sury-php.list
    echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" > /etc/apt/sources.list.d/sury-php.list


    MariaDB repo '''only''' if a very new version is needed:
    MariaDB repo '''only''' if a very new version is needed:


      wget https://mariadb.org/mariadb_release_signing_key.asc
    wget https://mariadb.org/mariadb_release_signing_key.asc
      apt-key add mariadb_release_signing_key.asc
    apt-key add mariadb_release_signing_key.asc
      rm mariadb_release_signing_key.asc
    rm mariadb_release_signing_key.asc
      echo "deb http://mirror.23media.de/mariadb/repo/10.4/debian $(lsb_release -sc) main" > /etc/apt/sources.list.d/mariadb.list
    echo "deb http://mirror.23media.de/mariadb/repo/10.4/debian $(lsb_release -sc) main" > /etc/apt/sources.list.d/mariadb.list


    Now we can install everything:
    Now we can install everything:


      apt-get install apache2
    apt-get install apache2
      apt-get install dovecot-core
    apt-get install dovecot-core
      apt-get install ejabberd # good candidate for backports
    apt-get install ejabberd # good candidate for backports
      apt-get install fail2ban
    apt-get install fail2ban
      apt-get install mariadb-server
    apt-get install mariadb-server
      apt-get install opendkim
    apt-get install opendkim
      apt-get install php7.4 # or whatever version we're on
    apt-get install php7.4 # or whatever version we're on
      apt-get install postfix
    apt-get install postfix
      apt-get install slapd
    apt-get install slapd


    Example for installing ejabberd from backports instead:
    Example for installing ejabberd from backports instead:


      apt-get install ejabberd/$(lsb_release -sc)-backports
    apt-get install ejabberd/$(lsb_release -sc)-backports


    === Fetch scripts & config repo ===
    === Fetch scripts & config repo ===
    Line 73: Line 73:
    Set up GitHub ssh access by copying the <code>.ssh/id_rsa</code> from the old server.  After that:
    Set up GitHub ssh access by copying the <code>.ssh/id_rsa</code> from the old server.  After that:
        
        
      cd ~
    cd ~
      git clone git@github.com:FeministWiki/FeministWiki.git repo
    git clone git@github.com:FeministWiki/FeministWiki.git repo
      cp -a repo/root/* .
    cp -a repo/root/* .
      openssl aes-256-cbc -d -md sha512 -pbkdf2 -iter 100000 -in repo/pwd.enc -out - | tar -xzf-
    openssl aes-256-cbc -d -md sha512 -pbkdf2 -iter 100000 -in repo/pwd.enc -out - | tar -xzf-


    The <code>openssl</code> decryption command will prompt you for a password.  Enter the password stored in <code>/root/pwd/meta</code> on the old server.
    The <code>openssl</code> decryption command will prompt you for a password.  Enter the password stored in <code>/root/pwd/meta</code> on the old server.
    Line 86: Line 86:
    === Create vmail user ===
    === Create vmail user ===


      groupadd -g 5000 vmail
    groupadd -g 5000 vmail
      useradd -u 5000 -g vmail -s /usr/sbin/nologin -d /home/vmail -m vmail
    useradd -u 5000 -g vmail -s /usr/sbin/nologin -d /home/vmail -m vmail


    === Initialize LetsEncrypt ===
    === Initialize LetsEncrypt ===

    Revision as of 22:56, 16 August 2021

    !!! WORK IN PROGRESS !!!

    These are the steps required to set up a new FeministWiki Debian server.

    Update & upgrade

    First of all, let's make sure the system is up to date.

    apt-get update
    apt-get upgrade
    apt-get dist-upgrade
    

    Install miscellaneous tools

    Some of these are needed further down, some are just good to have.

    apt-get install certbot
    apt-get install dnsutils
    apt-get install git
    apt-get install mg
    apt-get install moreutils
    apt-get install net-tools
    apt-get install nmap
    apt-get install software-properties-common
    apt-get install tree
    

    Set up firewall

    For now, block everything but SSH.

    apt-get install ufw
    ufw allow proto tcp to 0.0.0.0/0 port 22
    ufw enable
    

    Install server components

    We will now install all the software used for the various FeministWiki services. But first we might want to add some additional package repositories so we can use the latest version of some of the used software.

    Backports:

    echo deb http://deb.debian.org/debian $(lsb_release -sc)-backports main > /etc/apt/sources.list.d/backports.list
    

    PHP repo only if a very new version is needed:

    wget -O /etc/apt/trusted.gpg.d/sury-php.gpg https://packages.sury.org/php/apt.gpg
    echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" > /etc/apt/sources.list.d/sury-php.list
    

    MariaDB repo only if a very new version is needed:

    wget https://mariadb.org/mariadb_release_signing_key.asc
    apt-key add mariadb_release_signing_key.asc
    rm mariadb_release_signing_key.asc
    echo "deb http://mirror.23media.de/mariadb/repo/10.4/debian $(lsb_release -sc) main" > /etc/apt/sources.list.d/mariadb.list
    

    Now we can install everything:

    apt-get install apache2
    apt-get install dovecot-core
    apt-get install ejabberd # good candidate for backports
    apt-get install fail2ban
    apt-get install mariadb-server
    apt-get install opendkim
    apt-get install php7.4 # or whatever version we're on
    apt-get install postfix
    apt-get install slapd
    

    Example for installing ejabberd from backports instead:

    apt-get install ejabberd/$(lsb_release -sc)-backports
    

    Fetch scripts & config repo

    Set up GitHub ssh access by copying the .ssh/id_rsa from the old server. After that:

    cd ~
    git clone git@github.com:FeministWiki/FeministWiki.git repo
    cp -a repo/root/* .
    openssl aes-256-cbc -d -md sha512 -pbkdf2 -iter 100000 -in repo/pwd.enc -out - | tar -xzf-
    

    The openssl decryption command will prompt you for a password. Enter the password stored in /root/pwd/meta on the old server.

    Put config files in place

    TODO

    Create vmail user

    groupadd -g 5000 vmail
    useradd -u 5000 -g vmail -s /usr/sbin/nologin -d /home/vmail -m vmail
    

    Initialize LetsEncrypt

    The first run of Certbot has to be interactive, so we will do that now. Since the DNS entries still point to the old server, we can't get a cert for the real domains. For now, make feministwiki.dev point to the IP address of the new server, then proceed with the commands below.

    systemctl stop apache2
    certbot certonly --cert-name feministwiki.org  # Yes, it should be .org and not .dev
    

    Then follow the on-screen instructions of certbot. Use the "standalone" authentication method when asked, and enter feministwiki.dev as the sole domain.

    Stop services on old server

    At this point, all services on the old server should be stopped, because we will now begin to transfer all the actual data.

    Copy over LDAP databases

    TODO

    Copy over SQL databases

    TODO

    Copy over /var/www

    TODO

    Open ports

    We are finally ready to serve:

    for port in 25 80 443 465 587 993 995 5222 5223 5269 5270 5443 6697 7777
    do ufw allow proto tcp to 0.0.0.0/0 port $port
    done
    

    At this point you might want to do some testing with the feministwiki.dev domain.

    Reboot

    We could restart a lot of services manually, but it's easiest to just reboot.

    reboot
    

    Update DNS entries

    You have to change the configuration of the following domains:

    • feministwiki.org
    • feministwiki.net
    • feministwiki.de
    • fem.wiki
    • fffrauen.de

    feministwiki.org

    You only have to change three DNS entries, since most of the subdomains work via CNAME entries:

    • The main A entry for @ (self-reference i.e. feministwiki.org)
    • The A entry for smtp since this is not allowed to be a CNAME
    • The A entry for xmpp since this is not allowed to be a CNAME

    feministwiki.net, feministwiki.de, fem.wiki, fffrauen.de

    For these, you only have to change the main A entry, since they don't use SMTP or XMPP.

    Update the certificate

    Run the letsencrypt-refresh script to get a new certificate which includes all our domain names, since we had started out with just feministwiki.dev.