WikiVireGUL

VireGUL

Vous êtes ici : accueil » projets » yunohost » lstu

Projets:yunohost:lstu

LSTU, raccourcisseur d'URL

Procédure d'installation

1. Création d'un sous-domaine https://vrgl.fr dans Ouvaton

2. Création du domaine lien.viregul.fr dans Yunohost

3. Installation de l'application Lstu

- choisir le domaine vrgl.fr

- Theme choisi “milligun”

- Définition d'un mot passe admin

Patienter sans paniquer.

Retour dans Yunohost / domaines

Et regénérer le certificat dans Domaines / vrgl.fr / Installer un certificat Let's encrypt

Configuration - personnalisation

Copie de /var/www/lstu/themes/milligun en /var/www/lstu/themes/viregul

Changement du nom du site et du nom du logo (et taille) dans le fichier viregul/templates/layouts/default.html.ep

<div class="float-left hidden-xs logo">
<img src="<%= url_for('/img/lstuviregul.png') %>" alt="lstu logo" width="100" height="100">
</div>
<%= link_to url_for('/')(class'link_nocol') ⇒ begin %><h1 class="hennypenny">Et couic, le lien !</h1><% end %>

Création d'un dossier /var/www/lstu/themes/viregul/public/img/ et dépot d'une image lstuviregul.png dedans.

Modification du fichier /var/www/lstu/lstu.conf pour changer :

theme = milligun

en

theme = viregul

Surcharge d'une classe css dans themes/viregul/public/css/milli-lstu.min.css

.float-left.hidden-xs.logo {
    padding-right: 20px;
}

Et relancer le service avec :

sudo systemctl restart lstu

Sécurité - mot de passe admin

Changer la clef par défaut de chiffrement des cookies (pwgen 24) :

secrets => ['xei5WoohieChaileilaihook'],

Pour changer le mot de passe admin, éditer le fichier lstu.conf et lancer dans un terminal :

echo -n nouveaumotdepasse | sha256sum

Remplacer la chaine en sortie dans la valeur (en laissant la virgule à la fin) par exemple :

hashed_adminpwd ⇒ 'lach9iHuth1phoo4ohseeliec2FeShei4seingeek4tu2aixoade',

Et relancer le service :

systemctl restart lstu.service

Ceci vous permettra d'accéder aux stats, de supprimer des liens…

Mise à jour lstu

Sauvegarder /var/www/lstu dans le but de conserver : /var/www/lstu/thmes/viregul et /var/www/lstu/lstu.conf

Une fois la mise à jour effectuée, comparer les 2 lstu.conf et rétablir dans lstu.conf :

  • contact ⇒ contact@viregul.fr
  • secrets pour le chiffrement des cookies
  • hashed_adminpwd ⇒ remettre l'ancienne valeur
  • theme ⇒ viregul
  • disable_api ⇒ 1, pour désactiver l'API ouverte

Vérifier si le dossier “viregul” est encore présent dans les pads.

Et redémarrer le service :

systemctl restart lstu

Mise à jour buster

Après une mise à jour vers buster, les vieux modules perl sont obsolètes, il faut les re-générer :

sudo cpan Carton
cd /var/www/lstu/
sudo rm -rf local/
sudo carton install --deployment --without=sqlite --without=mysql
sudo systemctl restart lstu.service

Et vérifier que le service est bien actif et enable :

sudo systemctl status lstu.service