Skip to content

beanworks/YOURLS

 
 

Repository files navigation

Your Own URL Shortener

CI Scrutinizer Code Quality PHP Version Support Packagist OpenCollective OpenCollective

YOURLS is a set of PHP scripts that will allow you to run Your Own URL Shortener, on your server. You'll have full control over your data, detailed stats, analytics, plugins, and more. It's free and open-source.

Quick Start

Both the master and docker branches are missing the following files

  • nginx-selfsigned.crt
  • nginx-selfsigned.key
  • yourls.conf

To run Kubernetes version locally

  1. Install minikube, kubectl and Docker Desktop
  2. Clone the repo, download the missing files and open the master branch
  3. Change usernames and passwords in mysql.yaml, yourls.yaml and config.php to desired values
  4. cd to root of repo the following commands
kubectl create configmap yourls --from-file=config.php --from-file=index.php
kubectl create configmap nginx --from-file=nginx-selfsigned.crt --from-file=nginx-selfsigned.key --from-file=yourls.conf
kubectl apply -f .
  1. Open one terminal and run
sudo kubectl port-forward service/nginx 443:443
  1. Open another terminal and run
sudo kubectl port-forward service/yourls 80:80
  1. Leave them both running and go to http://localhost/admin/index.php to “install” yourls

To run Docker Compose version locally

  1. Install Docker Desktop
  2. Clone repo, download the missing files and open the docker branch
  3. Change usernames and passwords in .env.yourls, .env.mysql and config.php to desired values
  4. cd to root of repo and run
docker-compose up
  1. Go to http://localhost/admin/index.php to “install” yourls

License

Free software. Do whatever the hell you want with it.
YOURLS is released under the MIT license.

Releases

No releases published

Packages

No packages published

Languages

  • PHP 100.0%