<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Gayan Thakshila</title>
    <description>The latest articles on DEV Community by Gayan Thakshila (@cdsthakshila).</description>
    <link>https://dev.to/cdsthakshila</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4251015%2Fac86b23f-d5e2-485f-9dce-5c7f720ca460.png</url>
      <title>DEV Community: Gayan Thakshila</title>
      <link>https://dev.to/cdsthakshila</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/cdsthakshila"/>
    <language>en</language>
    <item>
      <title>How I Self-Hosted Worklenz (And Why It Was Easier Than I Expected)</title>
      <dc:creator>Gayan Thakshila</dc:creator>
      <pubDate>Wed, 18 Nov 2026 05:37:52 +0000</pubDate>
      <link>https://dev.to/cdsthakshila/how-i-self-hosted-worklenz-and-why-it-was-easier-than-i-expected-4876</link>
      <guid>https://dev.to/cdsthakshila/how-i-self-hosted-worklenz-and-why-it-was-easier-than-i-expected-4876</guid>
      <description>&lt;p&gt;I've been looking for a project management tool that I could run on my own server. Something where my data stays with me, and I don't have to worry about another monthly subscription. That's how I found Worklenz.&lt;/p&gt;

&lt;p&gt;Worklenz is open source, and the team has made self-hosting pretty painless. Here's how I got it running, step by step.&lt;/p&gt;

&lt;h2&gt;
  
  
  What you need first
&lt;/h2&gt;

&lt;p&gt;Before starting, make sure your machine (or server) has a few things installed:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Docker and Docker Compose&lt;/strong&gt; (this does most of the heavy lifting)&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Git&lt;/strong&gt; (to grab the code)&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Node.js 18+&lt;/strong&gt; and &lt;strong&gt;PostgreSQL 15+&lt;/strong&gt; if you plan to run it without Docker&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Honestly, if you go the Docker route, Docker and Git are all you really need to think about.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 1: Get the code
&lt;/h2&gt;

&lt;p&gt;Head over to the Worklenz GitHub repository and clone it to your machine. Then move into the project folder.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 2: Run the quick setup script
&lt;/h2&gt;

&lt;p&gt;This is my favorite part. Inside the project there's a script called &lt;code&gt;quick-setup.sh&lt;/code&gt;. Run it, and it takes care of the boring stuff for you:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;It creates your environment file with secure secrets already generated&lt;/li&gt;
&lt;li&gt;It sets up the URLs for your domain&lt;/li&gt;
&lt;li&gt;It handles SSL certificates (self-signed for local, Let's Encrypt for production)&lt;/li&gt;
&lt;li&gt;It starts all the services&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;No hunting for config values. No copy pasting random keys.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 3: Open it in your browser
&lt;/h2&gt;

&lt;p&gt;Once the script finishes, go to &lt;code&gt;localhost&lt;/code&gt; in your browser and Worklenz should be waiting for you. There's also a MinIO console on port 9001, which is where your uploaded files live.&lt;/p&gt;

&lt;p&gt;That's it for local setup. Seriously.&lt;/p&gt;

&lt;h2&gt;
  
  
  Going live on a real server
&lt;/h2&gt;

&lt;p&gt;If you want your team to use it, the process is almost the same:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Point your domain's DNS A record to your server's IP address.&lt;/li&gt;
&lt;li&gt;Clone the repo on your server.&lt;/li&gt;
&lt;li&gt;Run the same quick setup script, and enter your domain when it asks (something like &lt;code&gt;worklenz.yourcompany.com&lt;/code&gt;).&lt;/li&gt;
&lt;li&gt;Visit your domain with https and you're live.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;The script will grab a free SSL certificate from Let's Encrypt for you.&lt;/p&gt;

&lt;h2&gt;
  
  
  Keeping things running smoothly
&lt;/h2&gt;

&lt;p&gt;Worklenz comes with a handy &lt;code&gt;manage.sh&lt;/code&gt; script. With it you can check status, view logs, stop or start services, create backups, restore them, and even upgrade to the latest version. You can also turn on automatic backups and decide how many days to keep them (30 by default).&lt;/p&gt;

&lt;h2&gt;
  
  
  A few tips I learned
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Never push your &lt;code&gt;.env&lt;/code&gt; file to GitHub. It holds your secrets.&lt;/li&gt;
&lt;li&gt;Always use SSL in production.&lt;/li&gt;
&lt;li&gt;Set up automatic backups early. Future you will be grateful.&lt;/li&gt;
&lt;li&gt;Lock down your server with firewall rules.&lt;/li&gt;
&lt;li&gt;Check your logs once in a while.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;By default, Worklenz bundles PostgreSQL, Redis and MinIO together. If you'd rather use AWS S3, Azure Blob Storage or your own database, you can switch to "advanced" mode in the settings.&lt;/p&gt;

&lt;h2&gt;
  
  
  Wrapping up
&lt;/h2&gt;

&lt;p&gt;I expected self-hosting an agency management tool to eat my whole weekend. It took me less than 30 minutes. If you like owning your data, give Worklenz a try.&lt;/p&gt;

&lt;p&gt;If you get stuck, the &lt;a href="https://docs.worklenz.com/en/start/self-host/" rel="noopener noreferrer"&gt;official self-host guide&lt;/a&gt; has more detail, and there are video walkthroughs for both local and server setups.&lt;/p&gt;

&lt;p&gt;Happy hosting!&lt;/p&gt;

</description>
      <category>devops</category>
      <category>docker</category>
      <category>opensource</category>
    </item>
  </channel>
</rss>
