Cette page vous guidera durant l'installation manuelle et la configuration de Symbiose sur un serveur web.

Prérequis

Les prérequis sont disponibles dans le fichier README.

Téléchargement

Symbiose est disponible au téléchargement sur Github. Vous avez le choix entre :

• Télécharger une version précise, en la sélectionnant dans les tags.
• Télécharger la dernière révision dans une archive .zip ou dans une archive .tar.gz, qui bénéficiera des dernières mises à jour mais qui pourra être un peu moins stable.

La deuxième méthode est néanmoins recommandée, le webos étant en version bêta pour le moment.

Si vous avez un accès SSH sur votre serveur, il est conseillé de cloner le dépôt git :

git clone git://github.com/symbiose/symbiose.git

Copie des fichiers sur le serveur

Il vous suffit d'extraire l'archive téléchargée puis d'envoyer tous les fichiers sur votre serveur, par exemple avec FTP en utilisant Filezilla.

Attention ! Pour les utilisateurs d'un serveur Web autre que Apache (comme Nginx, Lighttp...), il faut absolument adapter la configuration du .htaccess à celui-ci (en particulier la réécriture d'URL). Vous trouverez des exemples de configuration dans les fichiers portant le nom des serveurs Web à la racine.

Attribut les droits au serveur web

Vous devez ensuite donner les droits de lecture et d'écriture des fichiers de webos à votre serveur web. Pour Apache, l'utilisateur associé est généralement www-data, mais certaines distributions Linux utilisent apache ou encore www (pour savoir de quel utilisateur il s'agit, exécutez ps aux | egrep '(apache|httpd)').

Vous pouvez lui donner ces droits soit en utilisant les ACL (si votre serveur le supporte):

cd webos
setfacl -R -m d:u:www-data:rwX,u:www-data:rwX .

Soit en définissant l'utilisateur apache en tant que propriétaire des fichiers:

cd webos
chown -R www-data .

Note: Bien que définir les permissions sur les fichiers à 0777 résoudrait tout vos problèmes, c'est généralement considéré comme une mauvaise pratique et peut conduire à d'éventuelles failles de sécurité.

A présent, vous devriez pouvoir accéder au webos via votre navigateur webos.

Configuration

Utilisateurs

Par défaut, Symbiose propose deux comptes d'utilisateur :

• demo (mot de passe : demo) - utilisateur par défaut, il peut modifier ses propres fichiers mais n'a aucun droit sur le système.
• admin (mot de passe : admin) - administrateur du système, il a tous les droits.

Attention, il vous faut absolument changer le mot de passe de l'utilisateur admin ! Laisser le mot de passe par défaut est une aubaine pour un utilisateur malveillant ! Il est même conseillé de changer le nom d'utilisateur de cet administrateur (créer un nouvel administrateur et supprimer celui par défaut).

Vous pouvez à tout moment ajouter/enlever des utilisateurs via l'application Paramètres système.

Quotas, limites

Par défaut, l'inscription sur le serveur est ouverte et il n'y a aucun quota imposé pour l'espace disque des utilisateurs. N'oubliez pas de modifier ces paramètres via l'application Paramètres système.

E-mails

Par défaut, Symbiose ne peut pas envoyer d'e-mails. Si vous voulez activer cette fonctionnalité (pour par exemple permettre aux utilisateurs de réinitialiser leur mot de passe par e-mail), éditez le fichier /etc/email.json et définissez enable a true :

{
	"enabled":true,
	"delay":60,
	"from":"Symbiose <[email protected]>"
}

delay est le délai minimum entre deux envois d'e-mail vers une même adresse, from est l’expéditeur des e-mails.

Serveur WebSocket

Symbiose peut être configuré pour utiliser un serveur WebSocket, qui est plus rapide qu'un serveur Web classique. De plus, vous pourrez créer/utiliser des applications comme la messagerie instantanée, la vidéoconférence ou le partage d’écran (ces applications sont en développement, mais indisponibles pour le moment).

Si vous êtes sur un serveur mutualisé, vous ne pourrez probablement pas démarrer le serveur WebSocket. Mais si vous utilisez votre propre serveur (ou votre ordinateur) ou un serveur dédié, vous pouvez activer le serveur WebSocket dans Paramètres système > WebSocket server > Configuration.