{"id":4055,"date":"2019-08-24T09:55:06","date_gmt":"2019-08-24T06:55:06","guid":{"rendered":"https:\/\/kifarunix.com\/?p=4055"},"modified":"2024-03-12T07:35:26","modified_gmt":"2024-03-12T04:35:26","slug":"install-automad-cms-on-debian-10-ubuntu-18-04","status":"publish","type":"post","link":"https:\/\/kifarunix.com\/install-automad-cms-on-debian-10-ubuntu-18-04\/","title":{"rendered":"Install Automad CMS on Debian 10\/Ubuntu 18.04"},"content":{"rendered":"\n<p>In this guide, we are going to learn how to install Automad CMS on Debian 10 \/Ubuntu 18.04. <a rel=\"noreferrer noopener\" aria-label=\"Automad (opens in a new tab)\" href=\"https:\/\/automad.org\/\" target=\"_blank\">Automad<\/a>&nbsp;is a file-based content management system and template engine written in PHP.&nbsp;It stores all content in human readable text files instead of the database and thus a site created with Automad is fully portable,&nbsp;easy to install&nbsp;and can be version controlled by using Git or Mercurial.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Installing Automad CMS on Debian 10\/Ubuntu 18.04<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Prerequisites<\/h3>\n\n\n\n<p>Automad is written in PHP and thus it requires a web server with PHP and PHP extensions installed in order to run. Here is a list of the minimum system requirements;<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Apache or Nginx web server<\/li>\n\n\n\n<li>PHP 7.4+<\/li>\n\n\n\n<li>On Apache servers, the mod_rewrite module should be enabled<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Run System Update<\/h3>\n\n\n\n<p>Run the commands below to update and upgrade your system packages.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>apt update<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">Install PHP and Required PHP Modules<\/h3>\n\n\n\n<p>Once the system update is done, proceed to install the required PHP and PHP modules. Automad, as of this writing requires PHP 7.4+ as of this writing, as per the <a href=\"https:\/\/automad.org\/getting-started\/system-requirements\" target=\"_blank\" rel=\"noreferrer noopener\">system requirements page<\/a>.<\/p>\n\n\n\n<p>PHP 7.2 is the default PHP version available on the default Ubuntu 18.04 repositories while PHP 7.3 is the default PHP versions on Debian 10.<\/p>\n\n\n\n<p>Thus, to install PHP 7.4 on Ubuntu 18.04\/Debian 10;<\/p>\n\n\n\n<p>Add the third party PPA repositories that provides PHP 7.4 packages;<\/p>\n\n\n\n<p>Ubuntu 18.04:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>add-apt-repository ppa:ondrej\/php --yes &amp;&gt; \/dev\/null<\/code><\/pre>\n\n\n\n<p>Debian 10:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>apt -y install lsb-release apt-transport-https ca-certificates <\/code><\/pre>\n\n\n\n<pre class=\"wp-block-code\"><code>wget -qO \/etc\/apt\/trusted.gpg.d\/php.gpg https:\/\/packages.sury.org\/php\/apt.gpg<\/code><\/pre>\n\n\n\n<pre class=\"wp-block-code\"><code>echo \"deb https:\/\/packages.sury.org\/php\/ $(lsb_release -sc) main\" &gt; \/etc\/apt\/sources.list.d\/php.list<\/code><\/pre>\n\n\n\n<p>Re-update the package cache;<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>apt update<\/code><\/pre>\n\n\n\n<p>Then run the command below to install PHP and the required extensions as well the Apache web server.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>apt install php7.4 php7.4-zip php7.4-curl php7.4-mbstring php7.4-gd php7.4-xml php7.4-xmlrpc php7.4-soap -y<\/code><\/pre>\n\n\n\n<p>Verify the version of PHP installed;<\/p>\n\n\n\n<p>Ubuntu 18.04<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>php -v<\/code><\/pre>\n\n\n\n<p>Debian 10 Buster<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>php -v<\/code><\/pre>\n\n\n\n<p>The output of both commands should be same;<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>PHP 7.4.28 (cli) (built: Feb 17 2022 16:06:19) ( NTS )\nCopyright (c) The PHP Group\nZend Engine v3.4.0, Copyright (c) Zend Technologies\n    with Zend OPcache v7.4.28, Copyright (c), by Zend Technologies<\/code><\/pre>\n\n\n\n<p>Apache web server is set to run and enabled to run on system boot.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>systemctl status apache2<\/code><\/pre>\n\n\n\n<pre class=\"scroll-box\"><code>\n\u25cf apache2.service - The Apache HTTP Server\n   Loaded: loaded (\/lib\/systemd\/system\/apache2.service; enabled; vendor preset: enabled)\n  Drop-In: \/lib\/systemd\/system\/apache2.service.d\n           \u2514\u2500apache2-systemd.conf\n   Active: active (running) since Wed 2022-02-23 18:30:23 EAT; 3s ago\n  Process: 14290 ExecStop=\/usr\/sbin\/apachectl stop (code=exited, status=0\/SUCCESS)\n  Process: 14295 ExecStart=\/usr\/sbin\/apachectl start (code=exited, status=0\/SUCCESS)\n Main PID: 14312 (apache2)\n    Tasks: 6 (limit: 2317)\n   CGroup: \/system.slice\/apache2.service\n           \u251c\u250014312 \/usr\/sbin\/apache2 -k start\n           \u251c\u250014316 \/usr\/sbin\/apache2 -k start\n           \u251c\u250014317 \/usr\/sbin\/apache2 -k start\n           \u251c\u250014318 \/usr\/sbin\/apache2 -k start\n           \u251c\u250014321 \/usr\/sbin\/apache2 -k start\n           \u2514\u250014322 \/usr\/sbin\/apache2 -k start\n\nFeb 23 18:30:23 cms.kifarunix-demo.com systemd[1]: Stopped The Apache HTTP Server.\nFeb 23 18:30:23 cms.kifarunix-demo.com systemd[1]: Starting The Apache HTTP Server...\nFeb 23 18:30:23 cms.kifarunix-demo.com systemd[1]: Started The Apache HTTP Server.\n<\/code><\/pre>\n\n\n\n<p>To confirm is Apache is set to run on system boot, run the command below.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>systemctl is-enabled apache2<\/code><\/pre>\n\n\n\n<p>If the output is <strong><code>enabled<\/code><\/strong>, otherwise, enable it to run on boot by running;<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>systemctl enable apache2<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">Download Automad CMS Installation Files<\/h3>\n\n\n\n<p>There are different ways in which you can install Automad; using &nbsp;<a href=\"https:\/\/automad.org\/getting-started#composer\" target=\"_blank\" rel=\"noopener\">Composer<\/a>,&nbsp;<a href=\"https:\/\/automad.org\/getting-started#docker\" target=\"_blank\" rel=\"noopener\">Docker<\/a>&nbsp;or&nbsp;manual&nbsp;download.<\/p>\n\n\n\n<p>We use manual method in this guide.<\/p>\n\n\n\n<p>Run the command below to download the Automad CMS installation files to the web root directory you defined in the Automad CMS Apache configuration file above.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>wget -qO automad-master.zip https:\/\/codeload.github.com\/marcantondahmen\/automad\/zip\/refs\/heads\/master<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">Install Automad CMS on Debian\/Ubuntu<\/h3>\n\n\n\n<p>Installing Automad CMS is as simple as unzipping the download files to Automad CMS web root directory.<\/p>\n\n\n\n<p>Extract Automad CMS Files<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>apt install zip -y<\/code><\/pre>\n\n\n\n<pre class=\"wp-block-code\"><code>unzip -q automad-master.zip -d \/var\/www\/html\/<\/code><\/pre>\n\n\n\n<p>Check the contents;<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>ls \/var\/www\/html\/<\/code><\/pre>\n\n\n\n<pre class=\"wp-block-code\"><code><strong>automad-master<\/strong>  index.html<\/code><\/pre>\n\n\n\n<p>Automad Files are under the <strong>automad-master<\/strong> directory.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Configure Apache For Automad CMS<\/h3>\n\n\n\n<p>Create Apache configuration file for Automad CMS with the following content;<\/p>\n\n\n\n<pre class=\"scroll-box\"><code>\ntee \/etc\/apache2\/sites-available\/automadcms.conf << 'EOL'\n&lt;VirtualHost *:80&gt;\n     ServerAdmin webadmin@kifarunix-demo.com\n     DocumentRoot \/var\/www\/html\/automad-master\n     ServerName cms.kifarunix-demo.com\n\n     &lt;Directory \/var\/www\/html\/automad-master&gt;\n          Options FollowSymlinks\n          AllowOverride All\n          Require all granted\n     &lt;\/Directory&gt;\n\n    ErrorLog ${APACHE_LOG_DIR}\/error.log\n    CustomLog ${APACHE_LOG_DIR}\/access.log combined\n\n&lt;\/VirtualHost&gt;\nEOL\n<\/code><\/pre>\n\n\n\n<p>Save the configuration file and quit and check configuration syntax.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>apachectl configtest<\/code><\/pre>\n\n\n\n<p>If all is well, you should get <strong>Syntax OK<\/strong>.<\/p>\n\n\n\n<p>Next, disable Apache default site and enable Automd CMS site<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>a2dissite 000-default.conf<\/code><\/pre>\n\n\n\n<pre class=\"wp-block-code\"><code>a2ensite automadcms.conf<\/code><\/pre>\n\n\n\n<p>Enable Apache Rewrite module;<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>a2enmod rewrite<\/code><\/pre>\n\n\n\n<p>Set the user and group ownership of the Automad CMS files to web server <strong>www-data<\/strong>.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>chown -R www-data: \/var\/www\/html\/automad-master\nchmod -R 755 \/var\/www\/html\/automad-master<\/code><\/pre>\n\n\n\n<p>Restart Apache2<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>systemctl restart apache2<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">Accessing Automad CMS<\/h3>\n\n\n\n<p>You can now access your Automad CMS site via <strong>http:\/\/&lt;your-defined-domain-name&gt;<\/strong>.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1604\" height=\"924\" src=\"https:\/\/kifarunix.com\/wp-content\/uploads\/2022\/02\/automad-cms-web-UI.png\" alt=\"Install Automad CMS on Debian 10\/Ubuntu 18.04\" class=\"wp-image-11703\" title=\"\" srcset=\"https:\/\/kifarunix.com\/wp-content\/uploads\/2022\/02\/automad-cms-web-UI.png?v=1645634084 1604w, https:\/\/kifarunix.com\/wp-content\/uploads\/2022\/02\/automad-cms-web-UI-768x442.png?v=1645634084 768w, https:\/\/kifarunix.com\/wp-content\/uploads\/2022\/02\/automad-cms-web-UI-1536x885.png?v=1645634084 1536w\" sizes=\"(max-width: 1604px) 100vw, 1604px\" \/><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\">Create Automad CMS User Account<\/h4>\n\n\n\n<p>To create Automad CMS user account, enter the Automad CMS dashboard, <strong>http:\/\/&lt;domain&gt;\/dashboard<\/strong>.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1887\" height=\"741\" src=\"https:\/\/kifarunix.com\/wp-content\/uploads\/2022\/02\/automad-create-user-account.png\" alt=\"\" class=\"wp-image-11704\" title=\"\" srcset=\"https:\/\/kifarunix.com\/wp-content\/uploads\/2022\/02\/automad-create-user-account.png?v=1645634116 1887w, https:\/\/kifarunix.com\/wp-content\/uploads\/2022\/02\/automad-create-user-account-768x302.png?v=1645634116 768w, https:\/\/kifarunix.com\/wp-content\/uploads\/2022\/02\/automad-create-user-account-1536x603.png?v=1645634116 1536w\" sizes=\"(max-width: 1887px) 100vw, 1887px\" \/><\/figure>\n\n\n\n<p>Fill in the username and password and download the user registration form and copy it under the <strong>\/config<\/strong> directory within your Automad CMS project directory.<\/p>\n\n\n\n<p>For example, in my case the <strong>accounts.php<\/strong> file is downloaded to ~\/downloads directory. To preserver the permissions, copy the file as <strong>www-data<\/strong>.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>sudo -u www-data cp ~\/accounts.php \/var\/www\/html\/automad-master\/config\/<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">Login to Automad CMS Site<\/h3>\n\n\n\n<p>Once you have the accounts form in place, login to Automad CMS via <strong>http:\/\/automadcms.example.com\/dashboard<\/strong><\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1893\" height=\"486\" src=\"https:\/\/kifarunix.com\/wp-content\/uploads\/2022\/02\/automad-cms-login.png\" alt=\"\" class=\"wp-image-11705\" title=\"\" srcset=\"https:\/\/kifarunix.com\/wp-content\/uploads\/2022\/02\/automad-cms-login.png?v=1645634144 1893w, https:\/\/kifarunix.com\/wp-content\/uploads\/2022\/02\/automad-cms-login-768x197.png?v=1645634144 768w, https:\/\/kifarunix.com\/wp-content\/uploads\/2022\/02\/automad-cms-login-1536x394.png?v=1645634144 1536w\" sizes=\"(max-width: 1893px) 100vw, 1893px\" \/><\/figure>\n\n\n\n<p>And there you go. You get to Automad CMS admin dashboard.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1880\" height=\"943\" src=\"https:\/\/kifarunix.com\/wp-content\/uploads\/2022\/02\/automad-dashboard.png\" alt=\"\" class=\"wp-image-11706\" title=\"\" srcset=\"https:\/\/kifarunix.com\/wp-content\/uploads\/2022\/02\/automad-dashboard.png?v=1645634162 1880w, https:\/\/kifarunix.com\/wp-content\/uploads\/2022\/02\/automad-dashboard-768x385.png?v=1645634162 768w, https:\/\/kifarunix.com\/wp-content\/uploads\/2022\/02\/automad-dashboard-1536x770.png?v=1645634162 1536w\" sizes=\"(max-width: 1880px) 100vw, 1880px\" \/><\/figure><\/div>\n\n\n<p>You have successfully installed Automad CMS on Debian 10\/Ubuntu 18.04. You can now explore it. Enjoy.<\/p>\n\n\n\n<p>Read more about Automad CMS on;<\/p>\n\n\n\n<p><a href=\"https:\/\/automad.org\/user-guide\" target=\"_blank\" rel=\"noreferrer noopener\" aria-label=\"Automad CMS User Guide (opens in a new tab)\">Automad CMS User Guide<\/a><\/p>\n\n\n\n<p>Related Tutorials;<\/p>\n\n\n\n<p><a href=\"https:\/\/kifarunix.com\/install-wondercms-with-nginx-on-debian-10\/\" target=\"_blank\" rel=\"noreferrer noopener\" aria-label=\" (opens in a new tab)\">Install WonderCMS with Nginx on Debian 10<\/a><\/p>\n\n\n\n<p><a rel=\"noreferrer noopener\" aria-label=\" (opens in a new tab)\" href=\"https:\/\/kifarunix.com\/install-wondercms-on-debian-10-buster\/\" target=\"_blank\">Install WonderCMS on Debian 10 Buster<\/a><\/p>\n\n\n\n<p><a href=\"https:\/\/kifarunix.com\/install-goaccess-on-ubuntu-18-04-debian-10-buster\/\" target=\"_blank\" rel=\"noreferrer noopener\" aria-label=\" (opens in a new tab)\">Install GoAccess on Ubuntu 18.04\/Debian 10 Buster<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>In this guide, we are going to learn how to install Automad CMS on Debian 10 \/Ubuntu 18.04. Automad&nbsp;is a file-based content management system and<\/p>\n","protected":false},"author":1,"featured_media":11708,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"rank_math_lock_modified_date":false,"footnotes":""},"categories":[121,1087],"tags":[1093,4635,1039,4634,67],"class_list":["post-4055","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-howtos","category-cms","tag-automad-cms","tag-automad-cms-ubuntu","tag-debian-10-buster","tag-install-automad-cms-on-ubuntu","tag-ubuntu-18-04","generate-columns","tablet-grid-50","mobile-grid-100","grid-parent","grid-50","resize-featured-image"],"_links":{"self":[{"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/posts\/4055"}],"collection":[{"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/comments?post=4055"}],"version-history":[{"count":5,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/posts\/4055\/revisions"}],"predecessor-version":[{"id":21176,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/posts\/4055\/revisions\/21176"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/media\/11708"}],"wp:attachment":[{"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/media?parent=4055"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/categories?post=4055"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/tags?post=4055"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}