Jannah Theme License is not validated, Go to the theme options page to validate the license, You need a single license for each domain name.
أجهزة ومعدات

How to Create Your Own Bookmark Manager with Linkding


Linkding is a simple, yet flexible web-based bookmark manager for Linux. Similar to offline bookmark managers, it allows you to create and annotate the web links that you have accumulated over time.

This article will show you how you can install Linkding on an Ubuntu 22.04 machine using Docker and Docker Compose. It will also highlight how you can create and manage a non-admin user inside your new Linkding instance.

Why Host Your Own Bookmark Manager using Linkding?

One of the biggest selling points of Linkding is that you can quickly deploy it on an existing server and use it within a few minutes. This means that you don’t need to provision a new machine, physical or otherwise, to host your own bookmark manager.

Linkding also extends the basic features found in most bookmark managers to include link sharing and multi-user mode. This makes it ideal for users who want to create a private collaborative platform for sharing links between a group.

Obtaining Linkding and Docker Compose

To deploy Linkding, you need to first install Docker along with its Docker Compose component. You can do that by fetching the program’s signing key from the developer’s website:

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

Create a new repository file for your Docker installation:

sudo nano /etc/apt/sources.list.d/docker.list

Paste the following line of code inside your new repository file:

deb [arch=amd64 signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu jammy stable

Reload your system’s package repositories by running the following command:

sudo apt update && sudo apt upgrade
sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin docker-buildx-plugin nginx

Obtaining and Deploying the Linkding Docker Container

Create a new folder for Linkding inside your home directory and go inside it:

mkdir ~/linkding && cd ~/linkding

Use your favorite text editor to create an empty “docker-compose.yml” file:

nano ./docker-compose.yml

Paste the following block of code inside your new compose file:

---
version: "3"
services:
  linkding:
    container_name: ${LD_CONTAINER_NAME:-linkding}
    image: sissbruecker/linkding:latest
    ports:
      - ${LD_HOST_PORT:-9090}:9090
    volumes:
      - ${LD_HOST_DATA_DIR:-./data}:/etc/linkding/data
    env_file:
      - .env
    restart: unless-stopped

Save your new docker-compose.yml, then create an environment file for your instance. This will contain all the custom variables for your new installation:

Paste the following block of code inside your new environment file:

LD_CONTAINER_NAME="linkding"
LD_HOST_PORT="9090"
LD_HOST_DATA_DIR="./data"
LD_SUPERUSER_NAME="linkding" # CHANGE WITH A SECURE USERNAME
LD_SUPERUSER_PASSWORD="linkding" # CHANGE WITH A SECURE PASSWORD
LD_DISABLE_BACKGROUND_TASKS="False"
LD_DISABLE_URL_VALIDATION="False"
LD_ENABLE_AUTH_PROXY="False"
LD_CSRF_TRUSTED_ORIGINS="https://linkding.your-domain-name.here"

Lastly, build your new Docker Container by running the following command:

Creating an Nginx Reverse Proxy for SSL

At this point, you now have a working instance of Linkding running on port 9090. However, to be able to access it publicly, you need to create a reverse proxy that will secure incoming connections using SSL.

Create a new site config file for your instance:

sudo nano /etc/nginx/sites-available/linkding

Paste the following block of code inside your new site file:

server {
    listen 80;
    listen [::]:80;
 
    root                    /var/www/html;
    server_name             linkding.your-domain-name.here;
 
    location / {
        proxy_set_header    X-Forwarded-For $remote_addr;
        proxy_set_header    Host $http_host;
        proxy_set_header    X-Forwarded-Proto $scheme;
        proxy_pass          http://localhost:9090;
    }
}

Remove the default site config file and create a symbolic link for your new config file to “/etc/nginx/sites-enabled”:

sudo rm /etc/nginx/default
sudo ln -s /etc/nginx/sites-available/linkding /etc/nginx/sites-enabled/linkding

Start and enable your Nginx daemon to apply its new settings:

sudo systemctl restart nginx
sudo systemctl enable --now nginx

Enabling SSL for Your Linkding Instance

Ensure that your machine has the most recent core snap binary:

Install the Electronic Frontier Foundation’s (EFF) Certbot snap package:

sudo snap install certbot --classic

Test whether your certbot installation is working properly by registering it to the EFF:

sudo certbot register --agree-tos -m ramces@email.invalid

Request for an SSL certificate for your instance by running the following command:

sudo certbot --nginx -d linkding.your-domain-name.here

Test whether your new instance is both secure and working by loading its address on a web browser.

A screenshot showing the login page for linkding.

Creating a New User in Linkding

Login to your new Linkding instance using the superuser credentials that you’ve provided in your “.env” file.

A screenshot showing a filled login prompt for Linkding.

Click the “Settings” link on the page’s upper right corner.

A screenshot highlighting the Settings link in the Linkding homepage.

Click the “Admin” tab on Linkding’s settings page. This will bring up the Linkding Administrator Panel.

A screenshot highlighting the Admin tab in the Linkding settings page.

To add a new user, click the “Add” link beside the Users row under the “Authentication and Authorization” category.

A screenshot highlighting the Add link under the users section in the Linkding admin panel.

Provide a username and a password for your new Linkding user, then click “Save” to activate your new user.

A screenshot showing a filled new user prompt.

Test whether your new user is working properly by logging in to it through a different browser session.

A screenshot demonstrating the working new user.

Disabling an Existing User in Linkding

To disable an existing user in Linkding, go to your instance’s administrator panel, then select the “Users” link under the “Authentication and Authorization” category.

A screenshot highlighting the Users link in Linkding admin panel.

Click the username that you want to disable. This will load the profile for that particular user.

Scroll down to the “Permissions” category, then uncheck the checkbox beside the “Active” label.

A screenshot highlighting the Active checkbox under the Linkding user panel.

Scroll down to the bottom of the page then click “Save” to fully disable the user.

Frequently Asked Questions

Can you install Linkding without using Docker?

No. The developers of Linkding designed it to only work with Docker containers. This is because the program has a number of co-dependencies that need to be deployed in a specific order and a specific way in order to work properly.

Is it possible to import existing bookmarks to Linkding?

Yes. It is possible to import a list of bookmarks from other external bookmark managers. For example, you can copy over your bookmarks from both Google Chrome and Microsoft Edge directly to Linkding.

Is it possible to backup the Linkding database outside Docker?

Yes. There are two ways to back up a Linkding database from its Docker container. First, you can go to the Settings page, then go to the “Export” category under the “General” tab. Under that, click the “Download” button to back up the bookmarks of the current user.

Second, you can login to your Linkding server and copy the “db.sqlite3” file in the “~/linkding/data” directory. The advantage of this approach over the former is that the “db.sqlite3” file contains the entire bookmark database for the entire instance.

Image credit: Lauren Mancke via Unsplash (Background) Linkding Github (Logo). All alterations and screenshots by Ramces Red.

Ramces Red

Ramces is a technology writer that lived with computers all his life. A prolific reader and a student of Anthropology, he is an eccentric character that writes articles about Linux and anything *nix.

Subscribe to our newsletter!

Our latest tutorials delivered straight to your inbox

اترك تعليقاً

لن يتم نشر عنوان بريدك الإلكتروني. الحقول الإلزامية مشار إليها بـ *

زر الذهاب إلى الأعلى