blob: c8a9b70220b25762c3e790bdea89b252560ecfda [file] [log] [blame]
Matthias Andreas Benkardb382b102021-01-02 15:32:21 +01001<!DOCTYPE html>
2<html>
3 <head>
4 <title>Preparing</title>
5 <meta name="viewport" content="width=device-width, initial-scale=1.0">
Matthias Andreas Benkardb382b102021-01-02 15:32:21 +01006 </head>
Matthias Andreas Benkard7b2a3a12021-08-16 10:57:25 +02007 <body style='background-color:#fff;color:#333;width: 60%;margin: 0 auto;text-align:left;font-family: Verdana, "Lucida Sans Unicode", sans-serif'>
8 <h1 style="color:#333;font-size:48px">What is happening?</h1>
9 <p style="color:green;font-weight:bold;">Please do not stop the stack while we are initializing the database or do other preparations.</p>
10 <p style="font-size:small"><b>What is happening?</b> - Nginx cannot connect to an upstream server or other services are not ready yet.<br>
11 This is fine if mailcow was just
Matthias Andreas Benkardb382b102021-01-02 15:32:21 +010012 installed or updated and can take a few minutes to complete.<br>
Matthias Andreas Benkard7b2a3a12021-08-16 10:57:25 +020013 Please check the logs or contact support if the error persists.</p>
14 <h2>Quick debugging</h2>
15 <p>Check Nginx and PHP logs:</p>
Matthias Andreas Benkard1ba53812022-12-27 17:32:58 +010016 <pre>docker compose logs --tail=200 php-fpm-mailcow nginx-mailcow</pre>
Matthias Andreas Benkard7b2a3a12021-08-16 10:57:25 +020017 <p>Make sure your SQL credentials in mailcow.conf (a link to .env) do fit your initialized SQL volume. If you see an access denied, you might have the wrong mailcow.conf:</p>
Matthias Andreas Benkard1ba53812022-12-27 17:32:58 +010018 <pre>source mailcow.conf ; docker compose exec mysql-mailcow mysql -u${DBUSER} -p${DBPASS} ${DBNAME}</pre>
19 <p>In case of a previous failed installation, create a backup of your existing data, followed by removing all volumes and starting over (<b>NEVER</b> do this with a production system, it will remove <b>ALL</b> data):</p>
20 <pre>BACKUP_LOCATION=/tmp/ ./helper-scripts/backup_and_restore.sh backup all</pre>
21 <pre>docker compose down --volumes ; docker compose up -d</pre>
Matthias Andreas Benkard7b2a3a12021-08-16 10:57:25 +020022 <p>Make sure your timezone is correct. Use "America/New_York" for example, do not use spaces. Check <a href="https://en.wikipedia.org/wiki/List_of_tz_database_time_zones">here</a> for a list.</p>
Matthias Andreas Benkardd1f5b682023-11-18 13:18:30 +010023 <br>Click to learn more about <a style="color:red;text-decoration:none;" href="https://docs.mailcow.email/#get-support" target="_blank">getting support.</a>
Matthias Andreas Benkardb382b102021-01-02 15:32:21 +010024 </body>
25</html>