urupam

urupam is a lightweight URL shortener built with Perl and Mojolicious, and backed by Redis.

Warning

It's a work in progress. API looks good but all the front part remains to do.

Basic requirements

• Perl 5.42.0
• Carton (handles perl deps)
• Redis

How to run

To run the application in development, you'll first need a Redis server.

The easiest way is to start a local Redis instance using Docker:

docker run --name mojo-redis -p 6379:6379 -d redis

Install Perl dependencies with Carton:

carton install

Start the application with morbo:

carton exec morbo bin/urupam

Application will listen on port 3000.

Installation

Run the installation script:

scripts/install.sh

Enable and start the systemd service:

sudo systemctl enable --now urupam

Using docker

Build the image and use the docker-compose file:

cd docker
docker build -t urupam .
docker compose up -d

License

This project is licensed under the GPLv3+ License. See the LICENSE file for details.