# Installation

[![image.png](https://docs.rakouns.bzh/uploads/images/gallery/2025-10/scaled-1680-/LBPimage-png.png)](https://docs.rakouns.bzh/uploads/images/gallery/2025-10/scaled-1680-/LBPimage-png.png)

### Prérequis

- Définir le nom de domaine sur le serveur
- Déclarer le nom de domaine via OVH

### Installation

##### Version

Tout d'abord, il faut définir la version que l'on veux, ainsi que l'édition :

```bash
TELEPORT_EDITION="oss"
TELEPORT_VERSION="17.4.3"
```

Ici on veut l'édition communautaire, donc gratuite, et non la version entreprise.

##### Script

Une fois cela fait, on peut lancer le script d'installation :

```bash
curl https://cdn.teleport.dev/install-v17.4.3.sh | bash -s ${TELEPORT_VERSION?} ${TELEPORT_EDITION?}
```

Cela télécharge le script d'installation avant de le lancer :

[![image.png](https://docs.rakouns.bzh/uploads/images/gallery/2025-10/scaled-1680-/Pm2image-png.png)](https://docs.rakouns.bzh/uploads/images/gallery/2025-10/scaled-1680-/Pm2image-png.png)

Une fois l'installation terminée, voici le retour console :

[![image.png](https://docs.rakouns.bzh/uploads/images/gallery/2025-10/scaled-1680-/NgCimage-png.png)](https://docs.rakouns.bzh/uploads/images/gallery/2025-10/scaled-1680-/NgCimage-png.png)

### Configuration

Il faut ensuite générer le fichier de configuration pour Teleport via la commande :

```bash
teleport configure -o file --cluster-name=teleport.rakouns.bzh
```

Cela créé le fichier /etc/teleport.yml

Il est préférable de faire en sorte que le service se lance automatiquement :

```bash
systemctl enable teleport
systemctl start teleport
```

### Interface web

On peut alors se rendre sur son interface web (http://<IP>:3080) pour vérifier son bon fonctionnement :

[![image.png](https://docs.rakouns.bzh/uploads/images/gallery/2025-10/scaled-1680-/LOPimage-png.png)](https://docs.rakouns.bzh/uploads/images/gallery/2025-10/scaled-1680-/LOPimage-png.png)

### Créer comptes :

```bash
tctl users add <username> --roles=editor,access --logins=<login,des,machines>
```

Il y a ensuite un retour console comme celui-ci :

```bash
User <"username"> has been created but requires a password. Share this URL with the user to complete user setup, link is valid for 1h:
https://teleport.rakouns.bzh:443/web/invite/46d49a7b4456c5421a2628bdcabe41c4
NOTE: Make sure teleport.rakouns.bzh:443 points at a Teleport proxy which users can access.
```

L'installation de base de Teleport est terminée, il est maintenant possible d'enrôler des ressources facilement grâce au guide de l'interface web.