xmobe / docker-yourls-1

Dockerize YOURLS service (Shorten URL Service)

Dockerize YOURLS - Your Own URL Shortener

Integrated Items

• Yourls - 1.8.1

Integrated Plugins

• timezones
• 302-instead
• dont-track-admins
• fallback_url_config
• force-lowercase
• mobile-detect
• dont-log-bots
• dont-log-crawler
• dont-log-health-checker

Usage

To run YOURLS service with customized config

$ vim env.mysql
$ vim env.yourls
$ docker-compose up [--build]

Dashboard

• Default Login Page: http://localhost/admin/index.php
• Default Username: see env.yourls
• Default Password: see env.yourls

Advanced

Create database backup

Execute backup.sh to get regular backup

Restore backup from backup file

Make sure there is no container running

$ docker-compose down
$ docker ps

Cleanup "mysql-data" volume

$ docker volume rm yourls_mysql-data

Make sure there is no sql file under "mysql-initdb" volume

$ rm -vf ./volumes/docker-entrypoint-initdb.d/*

Move the backup sql file to "mysql-initdb" volume

$ cp -vf ./mysql-dump-YYYYMMDD-hhmmss.sql ./volumes/docker-entrypoint-initdb.d/
$ docker-compose up -d

FAQ

How can I use non-default password or variables?

simply modify the variable configures in `env.*` before run

Known Issue

WebUI may show Could not write file .htaccess in YOURLS root directory. at first time deployment, it is actually a false alarm, please ignore it.

WebUI may show Could not auto-encrypt passwords. when log into admin page, it is Docker specific limitation, see YOURLS wiki for more detail