<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Afra4ap on Medium]]></title>
        <description><![CDATA[Stories by Afra4ap on Medium]]></description>
        <link>https://medium.com/@afra4ap?source=rss-10d7693b959e------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*SfzyGOMCpEVssRG24BR_oQ.jpeg</url>
            <title>Stories by Afra4ap on Medium</title>
            <link>https://medium.com/@afra4ap?source=rss-10d7693b959e------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Sun, 22 Nov 2026 10:15:48 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@afra4ap/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Syspass Installation On Ubuntu]]></title>
            <link>https://medium.com/@afra4ap/syspass-installation-on-ubuntu-48865b62e066?source=rss-10d7693b959e------2</link>
            <guid isPermaLink="false">https://medium.com/p/48865b62e066</guid>
            <category><![CDATA[docker-compose]]></category>
            <category><![CDATA[password-manager-app]]></category>
            <category><![CDATA[troubleshooting]]></category>
            <category><![CDATA[docker]]></category>
            <dc:creator><![CDATA[Afra4ap]]></dc:creator>
            <pubDate>Wed, 09 Aug 2023 10:05:22 GMT</pubDate>
            <atom:updated>2023-08-09T10:24:49.576Z</atom:updated>
            <content:encoded><![CDATA[<p>In this guideline, you will learn how to install Syspass in the Docker Compose method in detail.</p><blockquote><strong>if you know less about docker this documentation is good for you.</strong></blockquote><h4><strong>Pre-Requirements:</strong></h4><ul><li>Install Docker Engine from this <a href="https://docs.docker.com/engine/install/ubuntu/#set-up-the-repository"><em>link</em></a><em> </em>or follow the below steps.</li><li>Install Docker Compose from this <a href="https://docs.docker.com/compose/install/"><em>link</em></a><em> </em>or follow the below steps.</li><li>Create docker-compose.yml in your destination directory then add mentioned text on it.</li></ul><h4>Installing Docker</h4><p>1- setup repository:</p><pre>sudo apt-get update<br>sudo apt-get install ca-certificates curl gnupg</pre><p>2- Add docker’s official GPG key:</p><pre>sudo install -m 0755 -d /etc/apt/keyrings<br>curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg<br>sudo chmod a+r /etc/apt/keyrings/docker.gpg</pre><p>3- Use the following command to set up the repository:</p><pre>echo \<br>  &quot;deb [arch=&quot;$(dpkg --print-architecture)&quot; signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \<br>  &quot;$(. /etc/os-release &amp;&amp; echo &quot;$VERSION_CODENAME&quot;)&quot; stable&quot; | \<br>  sudo tee /etc/apt/sources.list.d/docker.list &gt; /dev/null</pre><p>4- update the apt package repository:</p><pre>sudo apt-get update</pre><p>5- Install Docker Engine:</p><pre>sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin</pre><h4>Installing Docker Compose</h4><p>After you install Docker, you need to install Docker Compose. so follow bellow steps:</p><pre>sudo apt-get update<br>sudo apt-get install docker-compose-plugin</pre><p>After this, you can test the Docker Compose by using the below command:</p><pre>sudo docker compose version</pre><p>In the third step, you should create a docker-compose.yml file and that has to be like this: (after the below code, you can have more information about it)</p><pre>version: &#39;2&#39;<br>services:<br>  app:<br>    container_name: syspass-app<br>    image: syspass/syspass:3.1.0 # Set this version tag to desired one<br>    restart: always<br>    # Will listen on ports 80 and 443 of the host<br>    ports:<br>      - &quot;80:80&quot;<br>      - &quot;443:443&quot;<br>    depends_on:<br>      - db<br>    volumes:<br>      - &lt;source-path&gt;:/var/www/html/sysPass/app/config <br>      - &lt;source-path&gt;:/var/www/html/sysPass/app/backup<br>    # Set USE_SSL=no if you&#39;re using a LB or reverse proxy for SSL offloading<br>    environment:<br>      - USE_SSL=yes<br>  db:<br>    container_name: syspass-db<br>    restart: always<br>    image: mariadb:10.2<br>    # Set a secure password for MariaDB root user<br>    environment:<br>      - MYSQL_ROOT_PASSWORD=syspass<br>    # This ports will only be accesible internally<br>    ports:<br>      - &quot;3306:3306&quot;<br>    volumes:<br>      - &lt;source-path&gt;:/var/lib/mysql</pre><p>In the volumes part, you can insert your intended path. It’s good to know that we specify a new path because we don’t want to lose our data when a container kills or goes for any reason. For more information, you can use read this <a href="https://docs.docker.com/storage/volumes/"><em>source</em></a> which is about addressing volume in Docker.</p><p>my recommend docker-compose.yml format is like this:</p><pre>version: &#39;2&#39;<br>services:<br>  app:<br>    container_name: syspass-app<br>    image: syspass/syspass:3.1.0 # Set this version tag to desired one<br>    restart: always<br>    # Will listen on ports 80 and 443 of the host<br>    ports:<br>      - &quot;80:80&quot;<br>      - &quot;443:443&quot;<br>    depends_on:<br>      - mysql<br>    volumes:<br>      - /etc/docker/syspass/syspass-config:/var/www/html/sysPass/app/config <br>      - /etc/docker/syspass/syspass-backup:/var/www/html/sysPass/app/backup<br>    # Set USE_SSL=no if you&#39;re using a LB or reverse proxy for SSL offloading<br>    environment:<br>      - USE_SSL=yes<br>  mysql:<br>    container_name: syspass-db<br>    restart: always<br>    image: mariadb:10.2<br>    # Set a secure password for MariaDB root user<br>    environment:<br>      - MYSQL_ROOT_PASSWORD=syspass<br>    # This ports will only be accesible internally<br>    ports:<br>      - &quot;3306:3306&quot;<br>    volumes:<br>      - /var/lib/syspass/mysql:/var/lib/mysql</pre><p>Then use the below command to deploy and set up the environment</p><pre>docker compose -p syspass -f docker-compose.yml up -d</pre><p>using the &lt;-p syspass &gt; option, which will create a separate network for the Syspass project.</p><blockquote>If you have a problem getting the image from the Docker hub, use another DNS address in /etc/resolv.conf or set proxy</blockquote><p>After you run the command above, run the command below to see whether containers are running or not:</p><pre>docker ps -a</pre><p>In this case, you should see the below result:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*XZjfalEqwKg0H2rSGovvng.png" /></figure><p>For checking the result, type <a href="https://127.0.0.1/">https://127.0.0.1</a> n your browser then you will see this page:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/511/1*wkuMwSs8aUV67jjQoBx-Pw.png" /></figure><p>The point is you will see this page just once. the reason is you just need to set up an admin user just after installation and no more.</p><p>But if you insert a password and master password (remember to save this info somewhere bc you need the master password for every user who wants to register), database access password (databank password), and database server (databank server), you will get errors like:</p><pre>Unable to connect to DB<br>Error 2002: SQLSTATE[HY000] [2002] No such file or directory</pre><pre>Unable to connect to DB<br>Error 2002: SQLSTATE[HY000] [2002] php_network_getaddresses: getaddrinfo failed: Name or service not known</pre><p>To resolve problems, you should know that Docker has a separate network, so you need to make your host know the container. therefore add some changes.</p><p>Go to your source path which stores the Syspass config, for example, I have access to it by this path:</p><pre>vim /etc/docker/syspass/syspass-config/config.xml</pre><p>then add these changes:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/984/1*5z6oDYzGeW5MrVcW3CzwWQ.png" /></figure><p>Refresh the Syspass web page in the browser then fill the blank place:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/489/1*qfwSD1oV_bp6ICNarSRCgQ.png" /></figure><ul><li>Syspass DB Access User: root</li><li>Syspass DB Access Password: syspass</li><li>Syspass DB name: syspass</li><li>Syspass DB server: mysql -&gt; as we set in config.xml file</li><li>Choose the English Language</li><li>Select the INSTALL button.</li></ul><p>after this, you can see the Login page, for evaluation, you can insert the admin and password which you set on the previous page.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/853/1*hVDK5huWyRBjOezIa4vJBA.png" /></figure><p>Taaadaaa! Everything was done perfectly. you can</p><p>I hope this article was good for you. In future articles, I will explain Syspass security tricks and other password managers!</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=48865b62e066" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>