<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
  <channel>
    <title>Relationship Management on D. Sébastien Taggart</title>
    <link>https://www.sebastientaggart.com/tags/relationship-management/</link>
    <description>Recent content in Relationship Management on D. Sébastien Taggart</description>
    <generator>Hugo</generator>
    <language>en</language>
    <lastBuildDate>Sun, 04 Oct 2026 23:02:59 -0400</lastBuildDate>
    <atom:link href="https://www.sebastientaggart.com/tags/relationship-management/index.xml" rel="self" type="application/rss+xml" />
    <item>
      <title>Setting Up Monica CRM with Docker Compose: A Step-by-Step Guide</title>
      <link>https://www.sebastientaggart.com/writing/setting-up-monica-crm-with-docker-compose-a-step-by-step-guide/</link>
      <pubDate>Sun, 27 Aug 2023 08:05:25 -0500</pubDate>
      <guid>https://www.sebastientaggart.com/writing/setting-up-monica-crm-with-docker-compose-a-step-by-step-guide/</guid>
      <description>&lt;h2 id=&#34;setting-up-monica-crm-with-docker-compose-a-step-by-step-guide&#34;&gt;Setting Up Monica CRM with Docker Compose: A Step-by-Step Guide&lt;/h2&gt;
&lt;p&gt;Monica is more than just a personal relationship management (PRM) tool; it’s your digital assistant, designed to help you cultivate and maintain the important connections in your life. Think of it as a CRM tailored for personal relationships rather than sales leads. Whether you want to remember friends&amp;rsquo; birthdays, track interactions, or simply keep your social life organized, Monica stands out as a powerful ally. And deploying it via Docker Compose? That’s like giving yourself the best toolkit for the job.&lt;/p&gt;</description>
      <content:encoded><![CDATA[<h2 id="setting-up-monica-crm-with-docker-compose-a-step-by-step-guide">Setting Up Monica CRM with Docker Compose: A Step-by-Step Guide</h2>
<p>Monica is more than just a personal relationship management (PRM) tool; it’s your digital assistant, designed to help you cultivate and maintain the important connections in your life. Think of it as a CRM tailored for personal relationships rather than sales leads. Whether you want to remember friends&rsquo; birthdays, track interactions, or simply keep your social life organized, Monica stands out as a powerful ally. And deploying it via Docker Compose? That’s like giving yourself the best toolkit for the job.</p>
<p>In this guide, I’ll walk you through the process of deploying Monica with Docker Compose, along with some recommendations to optimize your experience after setup.</p>
<hr>
<h3 id="step-1-prerequisites">Step 1: Prerequisites</h3>
<p>Before diving in, ensure you have Docker and Docker Compose installed on your machine. If this is your first experience with Docker, welcome to the world of containerization—where applications run consistently across environments, making deployment and updates a breeze.</p>
<ol>
<li><strong>Install Docker:</strong> Head over to <a href="https://docs.docker.com/get-docker/">Docker’s official website</a> for installation instructions tailored to your operating system.</li>
<li><strong>Install Docker Compose:</strong> Follow the <a href="https://docs.docker.com/compose/install/">Docker Compose installation instructions</a> to get set up.</li>
</ol>
<hr>
<h3 id="step-2-create-a-docker-composeyml-file">Step 2: Create a <code>docker-compose.yml</code> File</h3>
<p>Next, we’ll create a <code>docker-compose.yml</code> file to define how Monica will be set up. This file serves as a roadmap, detailing how to deploy the Monica application alongside a MySQL database—an essential component for storing your data.</p>
<p>Open your terminal, navigate to the directory where you want Monica to reside, and create a new <code>docker-compose.yml</code> file. Here’s a sample configuration to get you started:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">version</span><span class="p">:</span><span class="w"> </span><span class="s1">&#39;3&#39;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">services</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">monica</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">image</span><span class="p">:</span><span class="w"> </span><span class="l">monica:latest</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">env_file</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="l">.env</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">ports</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="s2">&#34;8080:80&#34;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">depends_on</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="l">db</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">db</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">image</span><span class="p">:</span><span class="w"> </span><span class="l">mysql:5.7</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">environment</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">MYSQL_ROOT_PASSWORD</span><span class="p">:</span><span class="w"> </span><span class="l">rootpassword</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">MYSQL_DATABASE</span><span class="p">:</span><span class="w"> </span><span class="l">monica</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">MYSQL_USER</span><span class="p">:</span><span class="w"> </span><span class="l">monica</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">MYSQL_PASSWORD</span><span class="p">:</span><span class="w"> </span><span class="l">monicapassword</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">volumes</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="l">monica_db_data:/var/lib/mysql</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">volumes</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">monica_db_data</span><span class="p">:</span><span class="w">
</span></span></span></code></pre></div><p>In this setup:</p>
<ul>
<li><strong>Monica</strong> runs as a dedicated service, pulling the latest image from Docker Hub.</li>
<li><strong>MySQL</strong> operates as a separate service, managing the database with specified environment variables for security.</li>
</ul>
<blockquote>
<p><strong>Note</strong>: Be sure to replace <code>rootpassword</code> and <code>monicapassword</code> with secure passwords.</p>
</blockquote>
<h3 id="step-3-create-an-env-file-for-monicas-environment-variables">Step 3: Create an <code>.env</code> File for Monica’s Environment Variables</h3>
<p>To keep sensitive information like database credentials separate from the <code>docker-compose.yml</code> file, we’ll create an <code>.env</code> file. This makes it easier to manage environment variables without editing the core configuration.</p>
<p>In the same directory, create a file named <code>.env</code>:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="nv">APP_KEY</span><span class="o">=</span>base64:YOUR_APP_KEY
</span></span><span class="line"><span class="cl"><span class="nv">APP_ENV</span><span class="o">=</span>production
</span></span><span class="line"><span class="cl"><span class="nv">APP_DEBUG</span><span class="o">=</span><span class="nb">false</span>
</span></span><span class="line"><span class="cl"><span class="nv">APP_URL</span><span class="o">=</span>http://localhost:8080
</span></span><span class="line"><span class="cl"><span class="nv">DB_HOST</span><span class="o">=</span>db
</span></span><span class="line"><span class="cl"><span class="nv">DB_DATABASE</span><span class="o">=</span>monica
</span></span><span class="line"><span class="cl"><span class="nv">DB_USERNAME</span><span class="o">=</span>monica
</span></span><span class="line"><span class="cl"><span class="nv">DB_PASSWORD</span><span class="o">=</span>monicapassword
</span></span></code></pre></div><p>For the <code>APP_KEY</code>, you’ll generate a new key after running the Monica container for the first time.</p>
<h3 id="step-4-run-docker-compose">Step 4: Run Docker Compose</h3>
<p>With your <code>docker-compose.yml</code> and <code>.env</code> files in place, it’s time to launch Monica:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">docker-compose up -d
</span></span></code></pre></div><p>Docker Compose will pull the necessary images, create the defined services, and start them in the background.</p>
<h4 id="step-5-generate-monicas"><strong>Step 5: Generate Monica’s <code>APP_KEY</code></strong></h4>
<p>To complete the application initialization, generate your <code>APP_KEY</code> by entering the Monica container:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">docker-compose <span class="nb">exec</span> monica php artisan key:generate --show
</span></span></code></pre></div><p>This command will output a new key that you should add to the <code>APP_KEY</code> field in your <code>.env</code> file. Once you’ve updated the key, restart the container:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">docker-compose down
</span></span><span class="line"><span class="cl">docker-compose up -d
</span></span></code></pre></div><p>Congratulations! Monica is now fully configured and accessible at <code>http://localhost:8080</code>.</p>
<hr>
<h2 id="initial-setup-recommendations">Initial Setup Recommendations</h2>
<p>After logging into the Monica dashboard for the first time, consider these steps to maximize your PRM experience:</p>
<h3 id="1-create-a-user-account">1. Create a User Account</h3>
<p>Start by setting up your initial user account. Follow the prompts, providing essential information and a secure password.</p>
<h3 id="2-configure-personal-details-and-preferences">2. Configure Personal Details and Preferences</h3>
<p>In your profile settings, add details like your name and birthday. These particulars enhance reminders and reports, so it’s worth taking a moment to fill them in.</p>
<h3 id="3-add-your-contacts">3. Add Your Contacts</h3>
<p>Begin by entering a few close contacts. Monica allows you to store extensive information for each person—birthdays, addresses, contact details, and even custom notes. As you add contacts, consider incorporating tags and relationships (e.g., family, friend, coworker) to help you stay organized.</p>
<h3 id="4-set-up-reminders-and-notifications">4. Set Up Reminders and Notifications</h3>
<p>Take advantage of Monica&rsquo;s ability to set reminders for birthdays, anniversaries, and other significant dates. This feature is a cornerstone of what makes Monica such a valuable PRM tool, so configure your reminders thoughtfully.</p>
<h3 id="5-explore-custom-fields-and-tags">5. Explore Custom Fields and Tags</h3>
<p>If you have specific information to track—like favorite activities or meeting history—utilize custom fields and tags. Tags are particularly useful for grouping contacts by characteristics like “work,” “family,” or “volunteer group,” making it easy to filter and find relevant connections.</p>
<h3 id="6-integrate-with-email-and-calendars">6. Integrate with Email and Calendars</h3>
<p>Monica can seamlessly integrate with various email and calendar applications, centralizing your reminders and events. Check the integrations section in settings for options that can streamline your contact management.</p>
<h3 id="7-regularly-back-up-your-data">7. Regularly Back Up Your Data</h3>
<p>While Docker Compose simplifies managing and maintaining your Monica installation, regular data backups are essential—especially if you’re entering sensitive or irreplaceable information. Consider setting up periodic backups of your database or using Docker volumes to create snapshots.</p>
<hr>
<h2 id="maintenance-tips">Maintenance Tips</h2>
<ul>
<li>
<p><strong>Updating Monica</strong>: When a new version of Monica is released, update by pulling the latest image and restarting the container with:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">docker-compose pull
</span></span><span class="line"><span class="cl">docker-compose up -d
</span></span></code></pre></div></li>
<li>
<p><strong>Checking Logs</strong>: To troubleshoot any issues, view logs for both services using <code>docker-compose logs monica</code> or <code>docker-compose logs db</code>.</p>
</li>
<li>
<p><strong>Restoring from Backup</strong>: Regular backups of the <code>monica_db_data</code> volume will simplify data recovery if needed.</p>
</li>
</ul>
<hr>
<p>With Docker Compose, deploying Monica CRM is straightforward and reliable. The application’s user-friendly interface and feature set make it an invaluable tool for managing personal relationships. Once you’re set up, you’ll find that Monica becomes a trusted assistant, helping you navigate life’s most important connections with ease.</p>
]]></content:encoded>
    </item>
  </channel>
</rss>
