Install Polr on CentOS 8

Using a Different System?

  • Install Polr on Ubuntu 18.04

Are we missing a guide for your target system? Request one, or submit your own!


Polr is a free and open-source link shortener written in PHP and Lumen. It allows you to quickly host your own URL shortener. It’s significant features include a management dashboard, detailed link analytics, and an API. This tutorial will guide you through the process of installing Polr on CentOS 8.


This tutorial requires a Vultr Cloud Compute instance with CentOS 8 and root access, and a valid domain name pointing to your server.

Install Apache

Polr requires a web server, a MySQL database, and PHP. For this tutorial we will be using the Apache web server.

Install the Apache web server.

dnf install httpd -ysystemctl enable httpd.service

Open ports 80 (HTTP) and 443 (HTTPS) through the firewall to be able to access the server from the internet.

sudo firewall-cmd --permanent --zone=public --add-service=httpsudo firewall-cmd --permanent --zone=public --add-service=httpssudo firewall-cmd --reload

Create a new Apache configuration file for the Polr installation.

nano /etc/httpd/conf.d/polr.conf

Paste the following snippet into the newly created file, replacing with your own domain name.

<VirtualHost *:80>    ServerName    ServerAlias    DocumentRoot "/var/www/html/public"    <Directory "/var/www/html/public">        Require all granted        Options Indexes FollowSymLinks        AllowOverride All        Order allow,deny        Allow from all    </Directory>    ErrorLog /var/log/httpd/error.log    CustomLog /var/log/httpd/access.log combined</VirtualHost>

Install PHP

Polr requires PHP and a number of PHP modules. Install PHP and the PHP modules required by Polr.

dnf install php php-xml php-pdo php-mysqlnd php-mbstring php-tokenizer php-json php-curl -y

Install MySQL & Create a Database

Polr stores data in an SQL database. Install and enable the MySQL server.

dnf install mysql-server -ysystemctl enable mysqld.servicesystemctl start mysqld.service

Secure the MySQL installation installation by running the provided script.


When prompted for a root password, choose a safe password and proceed through the installation.

Would you like to setup VALIDATE PASSWORD plugin? [Y/N] NNew password: <Your Password>Re-enter new password: <Your Password>Remove anonymous users? [Y/N] YDisallow root login remotely? [Y/N] YRemove test database and access to it? [Y/N] YReload privilege tables now? [Y/N] Y

Login to the MySQL console.

mysql -u root -p

When asked for a password, enter the root password created earlier. Once you are logged in to the console, create a new database for Polr.


Create a new database user and grant it privileges to the created database. You can replace username and password with the username and password of your choice.

mysql>CREATE USER 'username'@'localhost' identified by 'password';mysql>GRANT ALL PRIVILEGES on polr.* to 'username'@'localhost';mysql>FLUSH PRIVILEGES;

Exit the MySQL console.


Install Polr

Install git and clone the Polr repository from Github.

dnf install git -ycd /var/www/htmlgit clone --depth=1

Move the downloaded files to the root of the webserver.

mv ./polr/.[!.]* . && mv ./polr/* . && rm -rf polr

Download the Composr package. This is required to install dependencies.

curl -sS | php

Install the dependencies with Composr.

php composer.phar install --no-dev -o

Copy the provided configuration file to enable the web-based installer.

cp .env.setup .env

Set the appropriate file permissions.

chown -R apache:apache /var/www/html/chmod -R 755 /var/www/html/chcon -R -t httpd_sys_rw_content_t storage .env

Start the Apache web server.

systemctl start httpd.service

Complete the installation

Navigate to to launch the web-based Polr installer and enter the required information. Use the MySQL credentials created earlier for database configuration. Once you have submitted the setup form, the Polr installation will be completed.

Want to contribute?

You could earn up to $300 by adding new articles

Submit your article
Suggest an update
Request an article

No comments

Powered by Blogger.