How to Install LittleLink Custom on POP! OS Latest

LittleLink Custom is a URL shortener that allows you to create custom landing pages for your links. This tutorial will guide you through the installation process of LittleLink Custom on POP! OS Latest.

Prerequisites

Before we begin, make sure you have the following:

  • A system running POP! OS Latest
  • SSH access to your server
  • A domain name

Step 1: Connecting to Your Server

Log in to your server using SSH. You can use a terminal or an SSH client. Once connected, update the packages:

sudo apt update
sudo apt upgrade

Step 2: Installing Required Dependencies

LittleLink Custom requires some dependencies to function correctly. We must install them before installing LittleLink.

sudo apt install php php-curl libapache2-mod-php composer

We will also need to enable the rewrite module in Apache:

sudo a2enmod rewrite
sudo systemctl reload apache2

Step 3: Installing LittleLink Custom

Now that we have all the dependencies installed, let's download LittleLink Custom using the following command:

git clone https://github.com/adrien-f/LittleLink-Custom.git

Then navigate to the new directory using:

cd LittleLink-Custom/

Now that we're inside the little_link_custom directory, we need to install dependencies using Composer.

composer install

After Composer is finished installing dependencies, create a new MySQL database for LittleLink. Use the following command:

sudo mysql -u root -p
CREATE DATABASE littlelink_custom;
GRANT ALL PRIVILEGES ON littlelink_custom.* TO 'littlelink_custom_user'@'localhost' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;
exit

Next, copy and edit the configuration file:

cp .env.example .env
nano .env

DB_DATABASE=littlelink_custom
DB_USERNAME=littlelink_custom_user
DB_PASSWORD=password

Finally, let's run the following command to create a table for LittleLink:

php artisan migrate

Step 4: Configuring Apache

Now we need to configure Apache to serve LittleLink. Copy the .htaccess file to the public directory:

cp public/.htaccess.example public/.htaccess

Then create a new Apache site:

sudo nano /etc/apache2/sites-available/littlelink_custom.conf

Then input the following code:

<VirtualHost *:80>
    ServerName your_domain.com
    ServerAlias www.your_domain.com

    DocumentRoot /path/to/little_link_custom/public
    <Directory /path/to/little_link_custom>
        AllowOverride All
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/littlelink_custom_error.log
    CustomLog ${APACHE_LOG_DIR}/littlelink_custom_access.log combined
</VirtualHost>

Don’t forget to replace your_domain.com with your own domain and /path/to/little_link_custom with your actual path to the LittleLink directory.

Step 5: Restarting Apache

Finally, let's enable the site and restart Apache:

sudo a2ensite littlelink_custom.conf
sudo systemctl reload apache2

Conclusion

That's it! You have successfully installed LittleLink Custom on your POP! OS Latest server. Check the site by visiting https://your_domain.com. Happy Shortening!