Skip to content

asnux/welcome

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

asnux-welcome

Assistant de premier démarrage pour les mini-PC ASNUX (ASUS NUC préinstallés avec Ubuntu).

Au premier allumage de la machine, un terminal s'ouvre automatiquement avec un assistant qui guide le client pour sécuriser sa machine : créer son propre compte utilisateur, désactiver la connexion automatique, puis supprimer le compte technique asnux utilisé pendant la phase d'installation.

Pourquoi cet assistant existe

Nos machines sont livrées prêtes à l'emploi : Ubuntu déjà installé, connexion automatique activée, l'utilisateur arrive directement sur le bureau sans rien taper.

Cette commodité s'appuie sur un compte technique nommé asnux, mot de passe asnux, qui appartient au groupe sudo. Ce compte ne doit pas rester sur la machine du client final, pour deux raisons :

  1. Son mot de passe est public (mentionné dans nos pages produit et dans notre documentation) — quiconque accède physiquement à la machine peut s'en servir.
  2. Il a les pleins pouvoirs système via sudo, donc accède à tous les fichiers de tous les utilisateurs.

L'assistant règle ce problème dès la première session du client, sans qu'il ait besoin de connaître ni Linux ni la ligne de commande.

Comment auditer le code

Tout le code tient en bash, sans dépendance hors coreutils, gnome-terminal et sudo. La revue prend ~30 minutes. Ordre de lecture suggéré :

  1. bin/asnux-welcome — dispatcher qui décide quelle phase exécuter selon l'utilisateur courant.
  2. lib/phase1.sh — phase 1, sous le compte asnux : création du nouveau compte, désactivation auto-login, mise en place de la phase 2 dans le home du nouvel utilisateur.
  3. lib/phase2.sh — phase 2, sous le nouveau compte : vérification que sudo fonctionne, suppression du compte asnux, auto-désinstallation.
  4. lib/ui.sh, lib/i18n.sh, lib/ascii.sh — helpers d'affichage, traductions FR/EN, logo.
  5. share/asnux-welcome-phase1.desktop — entrée d'autostart GNOME.
  6. install.sh / uninstall.sh — installateur / désinstallateur.

Aucune connexion réseau, aucune télémétrie, aucun appel à un service externe. Le code est local et autonome.

Installation (sur une machine ASNUX en cours de préparation)

À exécuter avec sudo sur la machine cible après avoir installé Ubuntu et créé le compte asnux :

sudo ./install.sh

L'installateur copie les fichiers dans /opt/asnux-welcome/, crée le dossier d'état /var/lib/asnux-welcome/ et déploie l'autostart GNOME dans ~asnux/.config/autostart/. Au prochain login d'asnux, l'assistant se lance automatiquement.

Désinstallation

sudo ./uninstall.sh

Supprime les fichiers du système et les entrées d'autostart de tous les utilisateurs locaux.

Langues supportées

  • 🇫🇷 Français
  • 🇬🇧 Anglais

D'autres langues (AR, ZH, RU) viendront avec les traductions professionnelles du site.

Licence

MIT — vous pouvez auditer, copier, modifier et redistribuer librement.

About

No description, website, or topics provided.

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages