Copyparty est un serveur de fichiers (File Server) ultra-léger, rapide et polyvalent. Il permet de partager des fichiers, de diffuser du contenu multimédia et de gérer des téléversements (uploads) via une interface web moderne ou via des protocoles comme WebDAV, FTP et TFTP. Il est particulièrement apprécié pour sa faible consommation de ressources et sa facilité de déploiement.
Ce guide est un pas à pas complet pour installer et automatiser Copyparty dans un conteneur Debian sur Proxmox VE.
Voici à quoi ressemble Copyparty avec le thème sombre (Thème 2) une fois installé :

On commence par mettre à jour le système et installer les paquets nécessaires au fonctionnement du service et de l’indexation.
apt update && apt upgrade -y
apt install -y python3 python3-pip python3-jinja2 wget locate nano
Nous utilisons la version « SFX » (Single File Executable) qui regroupe tout le nécessaire dans un seul fichier Python.
mkdir -p /var/lib/copyparty /var/log/copyparty
wget https://github.com/9001/copyparty/releases/latest/download/copyparty-sfx.py -O /usr/local/bin/copyparty-sfx.py
chmod +x /usr/local/bin/copyparty-sfx.py
Il faut maintenant créer le fichier de configuration qui définit le comportement de Copyparty.
nano /etc/copyparty.conf
⚠️ IMPORTANT : Modifiez les valeurs suivies d’un commentaire
# <--pour correspondre à votre installation.
[global]
i: 0.0.0.0
p: 3923
ansi
e2dsa
e2ts
z, qr
theme: 2
grid
no-robots
# Configuration reverse proxy
rproxy: 1
xff-hdr: "X-Forwarded-For"
xff-src: 192.168.1.50 # <--- REMPLACEZ par l'IP de votre reverse proxy (Nginx/Traefik)
[accounts]
votre_utilisateur: votre_mot_de_passe # <--- MODIFIEZ votre login et mot de passe ici
[/]
/var/lib/copyparty
accs:
r: * # Lecture autorisée pour tous (public)
rwmda: votre_utilisateur # <--- REMPLACEZ par le nom d'utilisateur choisi ci-dessus
(Quittez nano avec Ctrl+O, Entrée, puis Ctrl+X).
Pour que Copyparty se lance automatiquement au démarrage du LXC.
nano /etc/systemd/system/copyparty.service
[Unit]
Description=CopyParty Service
After=network.target
[Service]
Type=simple
ExecStart=/usr/bin/python3 /usr/local/bin/copyparty-sfx.py -c /etc/copyparty.conf
Restart=always
[Install]
WantedBy=multi-user.target
systemctl daemon-reload
systemctl enable --now copyparty
On place le script dans le dossier /root/ pour un accès direct.
nano /root/update_copyparty.sh
#!/bin/bash
# Auteur : Amaury aka BlablaLinux (https://link.blablalinux.be)
# Description : Mise à jour automatique de Copyparty SFX
URL="https://github.com/9001/copyparty/releases/latest/download/copyparty-sfx.py"
DEST="/usr/local/bin/copyparty-sfx.py"
SERVICE_NAME="copyparty"
LOG="/var/log/copyparty/update.log"
# Téléchargement de la nouvelle version
wget -q $URL -O "$DEST.new"
# Comparaison avec l'ancienne version
if ! cmp -s "$DEST" "$DEST.new"; then
mv "$DEST.new" "$DEST"
chmod +x "$DEST"
systemctl restart $SERVICE_NAME
echo "$(date): Copyparty a été mis à jour et redémarré." >> $LOG
else
rm "$DEST.new"
echo "$(date): Copyparty est déjà à jour." >> $LOG
fi
chmod +x /root/update_copyparty.sh
Pour vérifier les mises à jour tous les dimanches à 4h00 du matin.
crontab -e
0 4 * * 0 /bin/bash /root/update_copyparty.sh > /dev/null 2>&1
python3 /usr/local/bin/copyparty-sfx.py --versioncat /var/log/copyparty/update.logsystemctl status copyparty