<?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>Self-Hosting on D. Sébastien Taggart</title>
    <link>https://www.sebastientaggart.com/tags/self-hosting/</link>
    <description>Recent content in Self-Hosting 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/self-hosting/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>
    <item>
      <title>Private Offline AI Photo Searching: A Guide to Protecting Your Family Photos</title>
      <link>https://www.sebastientaggart.com/writing/private-offline-ai-photo-searching-a-guide-to-protecting-your-family-photos/</link>
      <pubDate>Sat, 15 Jul 2023 20:03:41 -0500</pubDate>
      <guid>https://www.sebastientaggart.com/writing/private-offline-ai-photo-searching-a-guide-to-protecting-your-family-photos/</guid>
      <description>&lt;p&gt;When it comes to family photos, privacy isn’t just a luxury; it’s a necessity. Over the years, I’ve captured countless milestones—birthdays, vacations, and those fleeting, candid moments that linger in our hearts. But as my digital collection swelled, so did my frustration.&lt;/p&gt;
&lt;p&gt;It’s the classic scenario: “Where’s that photo of Alexander at the beach in 2017?” Or, “Can I quickly find all the pictures of grandma with the kids?” The manual search through thousands of images became a daunting chore. Enter AI-powered photo searching—a solution that seemed promising until I encountered the major caveat: &lt;strong&gt;privacy concerns.&lt;/strong&gt;&lt;/p&gt;</description>
      <content:encoded><![CDATA[<p>When it comes to family photos, privacy isn’t just a luxury; it’s a necessity. Over the years, I’ve captured countless milestones—birthdays, vacations, and those fleeting, candid moments that linger in our hearts. But as my digital collection swelled, so did my frustration.</p>
<p>It’s the classic scenario: “Where’s that photo of Alexander at the beach in 2017?” Or, “Can I quickly find all the pictures of grandma with the kids?” The manual search through thousands of images became a daunting chore. Enter AI-powered photo searching—a solution that seemed promising until I encountered the major caveat: <strong>privacy concerns.</strong></p>
<p>I wasn’t comfortable with the idea of uploading my family’s cherished moments to the cloud. My photos are personal, and I wanted to keep them offline, shielded from prying eyes and potential data breaches. This led me on a quest for tools that could harness the power of AI while preserving my privacy. Here’s what I discovered.</p>
<hr>
<h2 id="why-offline-ai-photo-searching-matters"><strong>Why Offline AI Photo Searching Matters</strong></h2>
<p>In a world overflowing with AI-driven photo management tools, the majority necessitate uploading images to the cloud. While such services offer undeniable convenience, they come with significant risks:</p>
<ol>
<li><strong>Privacy Concerns</strong>: Once you upload your photos, they’re subject to the whims of corporate privacy policies, which can shift unexpectedly. Do you really want a third party analyzing your family’s precious moments?</li>
<li><strong>Data Security</strong>: Even companies boasting robust security aren’t immune to breaches. Keeping your photos offline eliminates this risk entirely.</li>
<li><strong>Control</strong>: Storing and analyzing your photos locally empowers you with full control over their access and usage.</li>
</ol>
<p>For me, these reasons rendered an offline solution non-negotiable. Here are some tools that allow for private, AI-powered photo searching without compromising your privacy.</p>
<hr>
<h2 id="options-for-offline-ai-photo-searching"><strong>Options for Offline AI Photo Searching</strong></h2>
<h3 id="1-digikam"><strong>1. digiKam</strong></h3>
<p><strong>Overview</strong>: digiKam is a free, open-source photo management application that runs locally on your computer. It supports facial recognition and tagging, offering powerful organization and search tools.</p>
<p><strong>Features</strong>:</p>
<ul>
<li>Facial recognition for identifying and grouping people in photos.</li>
<li>Tagging and metadata support for effective categorization.</li>
<li>Advanced search functionality based on tags, dates, and EXIF data.</li>
</ul>
<p><strong>Pros</strong>:</p>
<ul>
<li>100% offline.</li>
<li>Highly customizable for power users.</li>
<li>Free and open-source.</li>
</ul>
<p><strong>Cons</strong>:</p>
<ul>
<li>The interface may feel dated and can overwhelm beginners.</li>
<li>Initial setup and the learning curve can be steep.</li>
</ul>
<hr>
<h3 id="2-photoprism"><strong>2. PhotoPrism</strong></h3>
<p><strong>Overview</strong>: PhotoPrism is an AI-powered photo management tool that you can self-host on your local machine or a private server. It’s crafted for privacy-conscious users, resembling cloud-based tools like Google Photos in functionality.</p>
<p><strong>Features</strong>:</p>
<ul>
<li>AI-powered object and facial recognition.</li>
<li>Automatic organization by dates, locations, and content.</li>
<li>Integration with Docker for straightforward deployment.</li>
</ul>
<p><strong>Pros</strong>:</p>
<ul>
<li>Fully private if self-hosted.</li>
<li>Modern, user-friendly interface.</li>
<li>Robust AI for searching by content (e.g., “beach” or “dog”).</li>
</ul>
<p><strong>Cons</strong>:</p>
<ul>
<li>Requires some technical know-how to set up and maintain.</li>
<li>Resource-intensive, particularly for large photo libraries.</li>
</ul>
<hr>
<h3 id="3-fastphototagger"><strong>3. FastPhotoTagger</strong></h3>
<p><strong>Overview</strong>: FastPhotoTagger is a lightweight photo tagging tool that integrates seamlessly with AI-powered libraries like TensorFlow for advanced users, though it doesn’t include AI capabilities natively.</p>
<p><strong>Features</strong>:</p>
<ul>
<li>Manual and batch tagging.</li>
<li>Simple search based on tags and metadata.</li>
<li>Lightweight and compatible with nearly any system.</li>
</ul>
<p><strong>Pros</strong>:</p>
<ul>
<li>Ideal for users who prefer manual control.</li>
<li>Extremely lightweight and fast.</li>
<li>Fully offline.</li>
</ul>
<p><strong>Cons</strong>:</p>
<ul>
<li>Lacks native AI functionality; relies on third-party tools.</li>
<li>Limited automation compared to other options.</li>
</ul>
<hr>
<h3 id="4-piwigo-self-hosted"><strong>4. Piwigo (Self-Hosted)</strong></h3>
<p><strong>Overview</strong>: Piwigo is a photo gallery solution that can be self-hosted for full privacy. While not inherently AI-driven, it can be enhanced with plugins for tagging and searching functionalities.</p>
<p><strong>Features</strong>:</p>
<ul>
<li>Web-based interface for easy browsing and searching.</li>
<li>Plugins available for facial recognition and tagging.</li>
<li>Scalable for large photo collections.</li>
</ul>
<p><strong>Pros</strong>:</p>
<ul>
<li>Fully self-hosted, ensuring complete control.</li>
<li>Highly customizable with a vibrant plugin ecosystem.</li>
<li>Suitable for both personal and professional use.</li>
</ul>
<p><strong>Cons</strong>:</p>
<ul>
<li>Requires technical setup.</li>
<li>Limited native AI functionality without plugins.</li>
</ul>
<hr>
<h3 id="5-simple-desktop-ai-tools"><strong>5. Simple Desktop AI Tools</strong></h3>
<p>For those comfortable experimenting, integrating open-source AI models like TensorFlow or OpenCV with a lightweight desktop tool allows for custom photo searching.</p>
<p><strong>How It Works</strong>:</p>
<ul>
<li>Train an AI model locally on your computer to recognize objects, faces, or scenes.</li>
<li>Use a desktop photo manager (e.g., digiKam or FastPhotoTagger) to organize the data.</li>
</ul>
<p><strong>Pros</strong>:</p>
<ul>
<li>Fully customizable for advanced users.</li>
<li>No data leaves your system.</li>
<li>Train the model on unique tags or categories.</li>
</ul>
<p><strong>Cons</strong>:</p>
<ul>
<li>Requires programming knowledge and time.</li>
<li>Not a turnkey solution for casual users.</li>
</ul>
<hr>
<h2 id="my-setup-combining-tools-for-the-best-experience"><strong>My Setup: Combining Tools for the Best Experience</strong></h2>
<p>After thorough research and testing, I settled on a combination of <strong>PhotoPrism</strong> and <strong>digiKam</strong>:</p>
<ol>
<li>
<p><strong>PhotoPrism for AI-Powered Search</strong>:<br>
I utilize PhotoPrism’s Docker-based setup for its intuitive interface and robust AI capabilities. It efficiently identifies faces and objects, streamlining my search for specific photos (e.g., “Alexander at the park”).</p>
</li>
<li>
<p><strong>digiKam for Detailed Organization</strong>:<br>
For manual tagging, adding metadata, and ensuring everything is backed up, digiKam provides the granularity I need.</p>
</li>
</ol>
<p><strong>How It Works</strong>:</p>
<ul>
<li>All photos are stored locally on a dedicated hard drive.</li>
<li>I leverage PhotoPrism’s AI to quickly find images by content or date.</li>
<li>For advanced tagging and metadata cleanup, I switch to digiKam.</li>
</ul>
<p>This hybrid approach gives me the best of both worlds: powerful AI search and complete offline control.</p>
<hr>
<h2 id="why-this-matters-for-my-family"><strong>Why This Matters for My Family</strong></h2>
<p>Choosing to self-host my family photos transcends privacy—it’s about preserving our memories securely and intentionally. Alexander can explore our family’s history without the anxiety of his images being used for advertising or stored on someone else’s servers.</p>
<p>Moreover, teaching him about how and why we safeguard our data has become a meaningful experience. He’s learning that technology isn’t merely about convenience; it’s about making conscious, informed choices.</p>
<hr>
<h2 id="conclusion"><strong>Conclusion</strong></h2>
<p>If you share my desire for the convenience of AI-powered photo searching without sacrificing privacy, offline solutions are your best bet. Tools like PhotoPrism and digiKam enable efficient organization and searching while keeping your family memories secure.</p>
<p>It might require a bit more effort than opting for a cloud service, but the peace of mind it brings is invaluable. After all, these photos encapsulate our lives—and that’s something truly worth protecting.</p>
]]></content:encoded>
    </item>
    <item>
      <title>Running a Self-Hosted Bookmarking Service with Shaarli</title>
      <link>https://www.sebastientaggart.com/writing/running-a-self-hosted-bookmarking-service-with-shaarli/</link>
      <pubDate>Sat, 29 Aug 2020 18:28:27 +0000</pubDate>
      <guid>https://www.sebastientaggart.com/writing/running-a-self-hosted-bookmarking-service-with-shaarli/</guid>
      <description>&lt;p&gt;In a world awash with digital content, finding a reliable way to manage your bookmarks without sacrificing privacy can feel like searching for a needle in a haystack. I wanted a solution that offered:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;A seamless user experience&lt;/li&gt;
&lt;li&gt;Robust privacy through self-hosting&lt;/li&gt;
&lt;li&gt;Simple setup via &lt;code&gt;docker&lt;/code&gt; and &lt;code&gt;docker-compose&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;Minimal resource consumption&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;While there’s no shortage of alternatives, like &lt;a href=&#34;https://github.com/wallabag/wallabag&#34;&gt;Wallabag&lt;/a&gt;, I found it to be slower and more resource-heavy than my chosen solution: Shaarli. Other options, such as &lt;a href=&#34;https://github.com/cdevroe/unmark&#34;&gt;Unmark&lt;/a&gt;, &lt;a href=&#34;https://github.com/MarceauKa/shaark&#34;&gt;Shaark&lt;/a&gt;, and &lt;a href=&#34;https://github.com/Kovah/LinkAce&#34;&gt;LinkAce&lt;/a&gt;, often attempt to offer too much, leading to unnecessary complexity and resource demands.&lt;/p&gt;</description>
      <content:encoded><![CDATA[<p>In a world awash with digital content, finding a reliable way to manage your bookmarks without sacrificing privacy can feel like searching for a needle in a haystack. I wanted a solution that offered:</p>
<ul>
<li>A seamless user experience</li>
<li>Robust privacy through self-hosting</li>
<li>Simple setup via <code>docker</code> and <code>docker-compose</code></li>
<li>Minimal resource consumption</li>
</ul>
<p>While there’s no shortage of alternatives, like <a href="https://github.com/wallabag/wallabag">Wallabag</a>, I found it to be slower and more resource-heavy than my chosen solution: Shaarli. Other options, such as <a href="https://github.com/cdevroe/unmark">Unmark</a>, <a href="https://github.com/MarceauKa/shaark">Shaark</a>, and <a href="https://github.com/Kovah/LinkAce">LinkAce</a>, often attempt to offer too much, leading to unnecessary complexity and resource demands.</p>
<h2 id="features-and-interface">Features and Interface</h2>
<p>Upon logging in, the interface presents a bit of visual clutter, yet it remains remarkably intuitive:</p>
<p><img alt="Shaarli Interface" loading="lazy" src="/writing/running-a-self-hosted-bookmarking-service-with-shaarli/assets/index-0e5ee54e.png"></p>
<p>The <strong>search</strong> functionality stands out—it&rsquo;s quick, highlights results, and operates seamlessly. No bells and whistles; it just works.</p>
<p>The feature set is well-curated, though I find the <strong>&ldquo;Picture wall&rdquo;</strong> somewhat superfluous. It pulls in logos or generic stock images from bookmarked pages, which, to be candid, doesn’t add much value for me.</p>
<p><img alt="Picture Wall" loading="lazy" src="/writing/running-a-self-hosted-bookmarking-service-with-shaarli/assets/index-ff7cf9c6.png"></p>
<p>The <strong>Tag Cloud</strong> is standard fare, but if you’re a fan, you’ll appreciate its instant search results. Typing reveals results quickly, which is a boon for efficiency.</p>
<p><img alt="Tag Cloud" loading="lazy" src="/writing/running-a-self-hosted-bookmarking-service-with-shaarli/assets/index-9ab903db.png"></p>
<p>One limitation is the lack of support for multi-word tags (think &ldquo;Professional Development&rdquo; instead of splitting it into &ldquo;Professional&rdquo; and &ldquo;Development&rdquo;). However, the team is aware of this issue and is working on it—progress is always welcome!</p>
<p><strong>Importing Links</strong> from the &ldquo;Tools&rdquo; menu is a breeze, handling my ~200 bookmarks effortlessly. Reports from other users indicate it scales well, accommodating thousands of links without a hitch.</p>
<h2 id="browser-plugins">Browser Plugins</h2>
<p>For Firefox enthusiasts, there exists a straightforward <a href="https://github.com/ikipatang/shaarli-web-extension">web extension</a> that allows you to add the current page to your Shaarli instance via a simple popup:</p>
<p><img alt="Firefox Extension" loading="lazy" src="/writing/running-a-self-hosted-bookmarking-service-with-shaarli/assets/index-3fa4acfc.png"></p>
<p>That said, the user experience here could use some refinement. The popup can sometimes hide behind the main window—an annoying hiccup. Scrolling is required, which begs the question: why not simplify the interface? An additional click is needed to save your bookmark, unlike the smooth single-click experience in native browsers. Despite these quirks, it does serve its purpose.</p>
<p>For Chromium users, there’s a similar <a href="https://chrome.google.com/webstore/detail/add-to-shaarli/jhfblapoehcfajokolimghdfmeeakbee">extension</a> available, alongside an <a href="https://play.google.com/store/apps/details?id=com.dimtion.shaarlier">Android utility</a>. However, I found the latter a bit cumbersome for regular use.</p>
<p>It’s important to note that neither extension currently allows for bookmark syncing.</p>
<h2 id="performance">Performance</h2>
<p>Shaarli excels in performance. Even when running in Docker on a five-year-old machine, the interface feels responsive, as if it&rsquo;s been pre-fetched. Actions like viewing bookmark details, searching, and adding tags occur with instant responsiveness.</p>
<h2 id="configuration">Configuration</h2>
<p>Setting up Shaarli locally is straightforward with <code>docker-compose</code>:</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">shaarli</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">shaarli/shaarli:master</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">container_name</span><span class="p">:</span><span class="w"> </span><span class="l">shaarli</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">restart</span><span class="p">:</span><span class="w"> </span><span class="l">unless-stopped</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="m">8093</span><span class="p">:</span><span class="m">80</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">./cache:/var/www/shaarli/cache</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="l">./data:/var/www/shaarli/data</span><span class="w">
</span></span></span></code></pre></div><p>In my setup, port <code>8093</code> is managed through a Caddy reverse proxy:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="c"># Shaarli Bookmark Manager</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="l">links.MYDOMAIN.com:80 {</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="l">proxy / localhost:8093 {</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="l">transparent</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="l">header_upstream X-Forwarded-Proto {scheme}</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span>}<span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="c"># Wildcard TLS is handled upstream</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="l">tls off</span><span class="w">
</span></span></span><span class="line"><span class="cl">}<span class="w">
</span></span></span></code></pre></div><p>Shaarli integrates smoothly behind any reverse proxy, requiring no special configuration tweaks.</p>
<h2 id="conclusion">Conclusion</h2>
<p>If you seek a fast, straightforward alternative to less secure public bookmark managers, I highly recommend giving Shaarli a try. As we continue to navigate the complexities of digital information, having a reliable and private bookmarking solution at your fingertips is not just beneficial—it’s essential.</p>
]]></content:encoded>
    </item>
  </channel>
</rss>
