Yourls: Install docs are dated - any chance of an update?

Created on 11 Nov 2018  路  6Comments  路  Source: YOURLS/YOURLS

The guides (nginx setup) were meant for Ubuntu 14 many years ago -- Following the guide now, I can't seem to get it to work (I had it working years ago when the guide was new: It seems like the guide is finally dated).

An updated guide would rock.

EDIT: Got it working, but only after several hours of _external_ (Google) sites rather than the install guide.

docs enhancement help wanted

All 6 comments

Thanks for your report @dylanh724!

There isn't any official guide how to install on a specific operating system. 馃
I'm not sure but I think you used the link "How to Install YOURLS on Ubuntu 14.04" in the "list of some (unofficial) install guides" on the readme.html.
As described, it is non-official and do not take preference over official docs like the wiki.

An updated guide would rock.

That said I agree, this readme can definitely be rewritten to refer to more updated ressources. 馃憤
If you've succeeded to get it working after some hard work, would you document your way and suggest your own guide there? Thx!

Actually, your wiki guide is just fine in my nginx setup:

https://github.com/YOURLS/YOURLS/wiki/Nginx-configuration

That wiki is actually awesome and up to date, but down low on Google and no where on that install page -- The wiki link belongs front+center of that /install page! Honestly, that would do just fine. You can keep those old guides, but preferably tag them "possibly outdated" below the wiki.

https://yourls.org/#Install

image

@dylanh724 OK, thanks a lot for your feedback, appreciated.

We are definitely opened for a PR to reflect your awesome suggestions! 馃憤

I had to restore a backup and now I'm back to 403 forbidden :P I forgot what I did to get it resolved, in the end. Something to do with either that wiki or using a different user for sql. Gahh... sorry.

EDIT: a chmod guide for YOURLS would be nice, too -- what should the main chmod -R be? And I heard /admin should have a different one? I'm horrible with chmod, so I'm just guessing. It'd probably just be a 1-liner guide. sudo chmod -R <xxx> ./ && sudo chmod -R <xxx> ./admin

I had to restore a backup and now I'm back to 403 forbidden

@dylanh724 That's totally unrelated to this issue! 馃槈

what should the main chmod -R be? And I heard /admin should have a different one?

??
As any other php app, all files and directories should be available for reads and writes for the same user used by the web server (and the PHP interpreter) (often www-data).

Does anyone use EasyEngine with their YOURLS?

I don't know if it will help you, but I just moved my YOURLS sites from pair.com (Ubuntu, Apache, MySQL) to linode.com (Debian, Nginx, MariaDB). I just started a Debian 8 image, then EasyEngine, then YOURLS. EasyEngine did most of the work for me (pretty much copy/paste two lines!). I then added only two lines of configuration and it worked fine! Thank You EasyEngine!

@dylanh724 The EasyEngine route to install YOURLS would allow EasyEngine to maintain the underlying packages of YOURLS.

I think we should make YOURLS easier for noobs to load and maintain so that someone with no PHP experience can quickly get a site running perfectly and can easily maintain it with simple copy/paste skills.

If anyone woud like it, I can write _a simple noob guide to installing YOURLS via EasyEngine!_ There are other VPS that this should work on besides Linode, such as Digital Ocean, I just prefer Linode, and have not tested the others.

Was this page helpful?
0 / 5 - 0 ratings

Related issues

schapsl picture schapsl  路  4Comments

Alan-Liang picture Alan-Liang  路  6Comments

LeoColomb picture LeoColomb  路  3Comments

ploedman picture ploedman  路  4Comments

LaughterOnWater picture LaughterOnWater  路  5Comments