123 lines
7.4 KiB
Markdown
123 lines
7.4 KiB
Markdown
---
|
|
title: Rotki
|
|
created: 2026-06-07
|
|
updated: 2026-06-07
|
|
type: app
|
|
tags: [catalogue, accounting, crypto, portfolio, defi, python, finance, fiscal]
|
|
confidence: high
|
|
contested: false
|
|
sources: [https://selfh.st/apps/?tag=Accounting, https://github.com/rotki/rotki, https://rotki.com/]
|
|
---
|
|
|
|
# Rotki 💰
|
|
|
|
> Suivi de portefeuille crypto et assistant comptable décentralisé — multi-chaîne, multi-portefeuille, avec calcul de plus-values fiscales, le tout en local et chiffré.
|
|
|
|
| Métadonnée | Valeur |
|
|
| :--- | :--- |
|
|
| **Site web** | https://rotki.com/ |
|
|
| **GitHub** | https://github.com/rotki/rotki |
|
|
| **License** | AGPL-3.0 |
|
|
| **Langage principal** | Python (backend) + Vue 3 / TypeScript (frontend) |
|
|
| **Étoiles GitHub** | ⭐737 |
|
|
| **Dernière MAJ** | 2026-05-30 |
|
|
| **Catégorie** | [[cat-accounting]] |
|
|
|
|
## Description
|
|
|
|
Rotki est un **assistant de suivi de portefeuille crypto et de comptabilité fiscale** écrit en Python (backend) avec un frontend Vue 3 / TypeScript. Sa philosophie est radicale : **vos clés et données financières restent sur votre machine**, chiffrées localement. Rotki ne se contente pas d'afficher un solde — c'est un véritable **logiciel comptable pour actifs numériques**, capable d'agréger des centaines de comptes, blockchains et protocoles DeFi dans une vue unique.
|
|
|
|
L'application supporte **plus de 35 blockchains** (Ethereum, Bitcoin, Solana, Polkadot, Cosmos, Arbitrum, Optimism, Base, Polygon, BNB Chain, Avalanche, etc.) et **des milliers de tokens**, avec des **connecteurs aux exchanges centralisés** (Binance, Coinbase, Kraken, KuCoin, Bitfinex, etc.) via API en lecture seule, et aux **protocoles DeFi** (Aave, Compound, MakerDAO, Lido, Curve, Uniswap, Yearn, Convex, etc.). Chaque transaction peut être **classifiée, annotée, regroupée** par événement fiscal (achat, vente, swap, staking, airdrop, NFT, emprunt, liquidation).
|
|
|
|
Le **module fiscal** est la pièce maîtresse pour les utilisateurs français/européens : il calcule les **plus-values selon la méthode de calcul choisie** (FIFO, LIFO, AC, HIFO), génère des **rapports PDF exportables** par année fiscale, et aide à remplir le formulaire **Cerfa 2086** (plus-values sur actifs numériques). Pour la France, l'application supporte explicitement le **régime flat tax 30%** (PFU) sur les plus-values de cession d'actifs numériques et la **déclaration d'ouverture/fermeture de compte** (formulaire 3916).
|
|
|
|
Le projet est **AGPL-3.0**, donc entièrement libre. Une **version Premium** (abonnement) débloque certaines intégrations premium (exchanges avancés, rapports fiscaux optimisés) et sert à financer le développement — la version gratuite reste très complète.
|
|
|
|
## Installation
|
|
|
|
### Via Docker (recommandé)
|
|
|
|
```yaml
|
|
# docker-compose.yml
|
|
services:
|
|
rotki:
|
|
image: rotki/rotki:latest
|
|
container_name: rotki
|
|
restart: unless-stopped
|
|
ports:
|
|
- "8082:80"
|
|
environment:
|
|
- TZ=Europe/Paris
|
|
volumes:
|
|
- rotki-data:/data
|
|
# Optionnel : exposition directe des RPC blockchain via Tor / VPN
|
|
|
|
volumes:
|
|
rotki-data:
|
|
```
|
|
|
|
### Installation manuelle (Desktop — méthode recommandée par l'éditeur)
|
|
|
|
1. Télécharger l'AppImage / DMG / installer Windows depuis https://github.com/rotki/rotki/releases.
|
|
2. Lancer l'application — au premier démarrage, **créer un nouveau compte chiffré** (mot de passe maître, fortement recommandé de le stocker dans un gestionnaire).
|
|
3. Ajouter des **adresses blockchain** (avec clés API d'observation, jamais de clés privées) ou des **comptes d'exchange** (API en lecture seule).
|
|
4. Lancer un **premier scan** : peut durer plusieurs minutes selon le nombre de comptes.
|
|
|
|
### Installation serveur (headless)
|
|
|
|
1. `git clone https://github.com/rotki/rotki.git && cd rotki`
|
|
2. Pré-requis : Python 3.11+, Node 20+, yarn.
|
|
3. Backend : `pip install -e .` puis `rotki --api-cors-domain http://localhost:8080 --data-dir /var/lib/rotki --rest-api-port 5042`.
|
|
4. Frontend : `cd frontend/app && yarn install && yarn build`, servir via Nginx.
|
|
5. Activer l'API REST (settings → Enable API) pour interfacer avec des outils tiers.
|
|
|
|
## Configuration
|
|
|
|
- **Comptes blockchain** : pour chaque adresse, choisir la chaîne (Ethereum, Solana, etc.) et la méthode d'observation (clé API Etherscan/BscScan/Polygonscan, ou nœud RPC personnel).
|
|
- **Comptes exchange** : créer une API en lecture seule (read-only) sur l'exchange, sans droit de retrait, et la coller dans Rotki.
|
|
- **Protocoles DeFi** : activables individuellement (Aave, Compound, Maker, Lido, etc.), chacun a son module de détection des positions.
|
|
- **Règles fiscales** : définir la méthode de calcul des plus-values (FIFO par défaut en France, recommandé), la devise de référence (EUR), et l'année fiscale.
|
|
- **Catégories de transactions** : customisables (staking, airdrop, mining, gift, lost, stolen, transfer entre wallets personnels — exonéré).
|
|
- **Rapports** : PDF/CSV exportables, par année, par compte, par type d'événement.
|
|
|
|
## Alternatives
|
|
|
|
### Open source
|
|
- [[app-ezbookkeeping]] — comptabilité personnelle multi-devises, plus généraliste, support crypto basique.
|
|
- **Koinly** — référence crypto/fiscal en SaaS, données hébergées, freemium.
|
|
- **CoinTracker** — équivalent cloud, freemium, fiscal US-centric.
|
|
- **Zerion** — wallet DeFi avec suivi de portefeuille (cloud).
|
|
- **DeBank** — dashboard DeFi read-only (cloud).
|
|
- **Bitcoin Core + Electrum** — bas niveau, sans notion de fiscal.
|
|
|
|
### Propriétaires
|
|
- **Koinly** — leader du marché, interface très léchée, freemium jusqu'à 1000 transactions.
|
|
- **CoinTracker** — idem, fort aux US.
|
|
- **CryptoTaxCalculator** — australien, très précis sur DeFi.
|
|
- **Accointing** (Blockpit) — européen (allemand), conforme MiCA, freemium.
|
|
|
|
## Sécurité
|
|
|
|
- **Clés en local uniquement** : Rotki n'expose **jamais vos clés privées**. Pour les comptes blockchain, on utilise des **clés API d'observation** (Etherscan, etc.) ou des **nœuds RPC personnels** (ex : Erigon pour Ethereum) qui ne permettent que la lecture.
|
|
- **Chiffrement local** : la base SQLite est chiffrée au repos avec un mot de passe maître (AES-256). En cas de vol du serveur, les données sont inexploitables.
|
|
- **API en lecture seule** sur les exchanges : créer des clés **sans droit de retrait** ni de trade. Ajouter une **whitelist IP** côté exchange si possible.
|
|
- **HTTPS obligatoire** : si on expose l'API REST sur un réseau, passer par un reverse proxy avec TLS.
|
|
- **Sauvegardes chiffrées** : la base `rotki-data` contient l'historique fiscal complet — sauvegarder en double (BorgBackup vers un NAS distant).
|
|
- **Mises à jour** : suivre les releases, le projet intègre régulièrement de nouvelles blockchains et corrige des bugs de classification DeFi.
|
|
|
|
## Ressources
|
|
- Site officiel : https://rotki.com/
|
|
- Documentation : https://docs.rotki.com/
|
|
- Dépôt GitHub : https://github.com/rotki/rotki
|
|
- Forum communautaire : https://github.com/rotki/rotki/discussions
|
|
- Wiki fiscal France : https://docs.rotki.com/usage-guides/fiscal.html
|
|
- selfh.st : https://selfh.st/apps/?tag=Accounting
|
|
|
|
## Pages Liées
|
|
- [[cat-accounting]] (catégorie parente)
|
|
- [[app-ezbookkeeping]] — comptabilité personnelle multi-devises
|
|
- [[app-firefly-iii]] — gestion budget, support crypto basique
|
|
- [[app-akaunting]] — comptabilité entrepreneur classique
|
|
- [[recettes-docker-compose]] — templates de déploiement
|
|
- [[securisation-home-lab]] — bonnes pratiques chiffrement / sauvegardes
|