How to Install Linkding with Docker on AlmaLinux 8
Linkding is a simple bookmark service that you can host yourself. It's designed to be minimal, fast, and easy to set up using Docker. In this article, we are going to learn how to install Linkding on AlmaLinux 8. So, let’s get started.
Checkout the Linkding Project Here.
Try this wiki on our VPS. Starting at just $5/month with 24x7 In-house customer support.
Pre-requisites
-
A system with AlmaLinux 8 installed and running.
-
root
access to the system. - Docker installed and running, for this, you can refer to one of our guides on installing Docker on AlmaLinux 8.
Once you're all set, we'll proceed with Linkding installation and configuration.
Install Nginx
Let's begin with installing Nginx. Install using the below codes.
yum install nginx -y
Enable services
systemctl enable nginx
systemctl start nginx
systemctl status nginx
Enable Firewall
firewall-cmd --permanent --add-service=http
firewall-cmd --permanent --add-service=https
firewall-cmd --reload
Install Let’s Encrypt SSL Certificate
Let's issue an SSL certificate for the domain. For this, we will need the EPEL repository
and the mod_ssl package
on AlmaLinux 8 operating system.
Update and install EPEL repository
and the mod_ssl package
on the system using the below command:
dnf install epel-release mod_ssl -y
Next, we will install the certbot client which is used to create Let's Encrypt certificates:
dnf install python3-certbot-nginx -y
Install SSL Certificate
Use the certbot command to issue a Let's Encrypt certificate. Replace dev.domainhere.info
and dev@dev.domainhere.info
with your domain name and email:
certbot --nginx --agree-tos --redirect --hsts --staple-ocsp --email dev@dev.domainhere.info -d dev.domainhere.info
SSL certificates are valid for 90 days. The renewal process is now automated, you do not have to renew this manually.
Restart Nginx
Restart apache to avoid getting error messages.
systemctl restart nginx
Configuring Nginx Server Blocks
Let's configure nginx.conf
with the following command:
nano /etc/nginx/nginx.conf
Replace the nginx.conf
file with the below configuration.
# For more information on configuration, see:
# * Official English Documentation: http://nginx.org/en/docs/
# * Official Russian Documentation: http://nginx.org/ru/docs/
user nginx;
worker_processes auto;
error_log /var/log/nginx/error.log;
pid /run/nginx.pid;
# Load dynamic modules. See /usr/share/doc/nginx/README.dynamic.
include /usr/share/nginx/modules/*.conf;
events {
worker_connections 1024;
}
http {
log_format main '$remote_addr - $remote_user [$time_local] "$request" '
'$status $body_bytes_sent "$http_referer" '
'"$http_user_agent" "$http_x_forwarded_for"';
access_log /var/log/nginx/access.log main;
sendfile on;
tcp_nopush on;
tcp_nodelay on;
keepalive_timeout 65;
types_hash_max_size 2048;
include /etc/nginx/mime.types;
default_type application/octet-stream;
# Load modular configuration files from the /etc/nginx/conf.d directory.
# See http://nginx.org/en/docs/ngx_core_module.html#include
# for more information.
include /etc/nginx/conf.d/*.conf;
}
Now, type Ctrl+O
and type Ctrl+X
to save and exit the file.
Create a new Nginx configuration file dev.conf
for the domain with the following command:
vi /etc/nginx/conf.d/dev.conf
Add the following codes:
Replace
dev.domainhere.info
&192.169.7.180
withYour Domain Name & IP
and Change SSL Path according to your SSL Path.
upstream app {
server 192.169.7.180:9090;
}
server {
listen 80 default_server;
server_name dev.domainhere.info;
return 301 https://$server_name$request_uri;
}
server {
listen 443 ssl; # managed by Certbot
# The host name to respond to
server_name dev.domainhere.info;
ssl_certificate /etc/letsencrypt/live/dev.domainhere.info/fullchain.pem; # managed by Certbot
ssl_certificate_key /etc/letsencrypt/live/dev.domainhere.info/privkey.pem; # managed by Certbot
include /etc/letsencrypt/options-ssl-nginx.conf; # managed by Certbot
ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem; # managed by Certbot
location / {
proxy_pass http://app;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $remote_addr;
proxy_set_header Host $host;
proxy_set_header X-Real-Port $server_port;
proxy_set_header X-Real-Scheme $scheme;
}
}
Now, press the Esc
key, and type :wq!
and press the Enter
key to save and exit the file.
For SELinux enabled systems, Run the below command
setsebool -P httpd_can_network_connect 1
Now, restart & check the Nginx with the following commands:
systemctl restart nginx
systemctl status nginx
Enable port 9090
To enable connection through the firewall, follow the commands:
firewall-cmd --zone=public --permanent --add-port 9090/tcp
firewall-cmd --reload
Install Linkding with Docker
The following instructions use the Docker service to install Linkding using the Linkding Docker Image. Let's install Linkding with Docker using the below commands:
docker run --name linkding -p 9090:9090 -v /data:/data -d sissbruecker/linkding:latest
The installation process will start now. It may take 5-10 mins to complete.
Adding Super User Setup
Finally, you need to create a user so that you can access the application. Replace the credentials in the following command and run it:
Replace username crowncloud
with your username and replace email dev@dev.domainhere.info
with your email id.
docker exec -it linkding python manage.py createsuperuser --username=crowncloud --email=dev@dev.domainhere.info
The command will prompt you for a secure password. After the command has completed you can start using the application by logging into the UI with your credentials.
Accessing Linkding
Now open the IP address or Domain name from your browser, this will redirect you to the Linkding.
https://dev.domainhere.info
Replace the
dev.domainhere.info
with the actual IP or domain configured on the server.
Follow the below steps:
Now you have successfully installed Linkding with Docker on AlmaLinux 8.