A set-and-forget Tezos NFT preservation app that pins your NFT assets to IPFS.
Porcupin automatically monitors your Tezos wallets and backs up all NFT content (images, metadata, videos) to IPFS. Once configured, it runs in the background keeping your digital art collection safe—forever.
🌐 Website: porcupin.xyz
Porcupin is seeking funding through the Tezos Ecosystem DAO!
Help us build and maintain this open-source tool for the Tezos community. Vote on our proposal until December 10th, 2025:
Connect any Tezos wallet to vote. Your Tez is your vote!
💜 We also accept Tezos donations: tz1U4wbRsojw1uWcNUpVMK2uihuhhXFYNVg3
| I want to... | Go here |
|---|---|
| Install and use Porcupin | User Guide |
| Build from source | Developer Guide |
| Update Porcupin | Updating Guide |
| Data Backup & Recovery | Backup Strategy |
| Contribute code | Contributing Guide |
| Understand the architecture | Architecture Docs |
- 🦔 Set and Forget — Add wallets once, Porcupin handles the rest
- 📌 IPFS Pinning — Embedded Kubo node, no external services needed
- 🔄 Real-time Sync — Watches for new NFTs via TZKT
- 💻 Cross-Platform — macOS, Windows, Linux, Raspberry Pi, Docker
- 🌐 Remote Server Mode — Run headless on NAS/Pi, manage from desktop app
- 📊 Dashboard — Track sync status, storage usage, failed assets
- 🔒 Self-Sovereign — Your data stays on your machine
👉 See the User Guide for complete installation instructions.
- Which binary do I need?
- Desktop App (macOS, Windows, Linux)
- Headless Server (Ubuntu, Raspberry Pi)
- Docker
- Configuration
- Troubleshooting
| Platform | Desktop (GUI) | Headless (CLI) | Docker |
|---|---|---|---|
| macOS (Intel) | ✅ | ✅ | ✅ |
| macOS (Apple Silicon) | ✅ | ✅ | ✅ |
| Windows x64 | ✅ | — | ✅ |
| Windows ARM64 | ✅ | — | ✅ |
| Linux x64 | ✅ | ✅ | ✅ |
| Linux ARM64 (Pi) | — | ✅ | ✅ |
We welcome contributions from developers of all skill levels! Please read our Contributing Guide before getting started.
Quick links:
Look for issues labeled good first issue to get started!
This project is licensed under the MIT License — see the LICENSE file for details.
You are free to use, modify, and distribute this software. We just ask that you give credit where it's due! 💜
FAFOlab
fafolab.xyz · info@fafolab.xyz
This project was made possible by these incredible open-source technologies:
- Wails — The Go/React desktop application framework
- Kubo IPFS — The implementation of IPFS used for embedded pinning
- TZKT — The premier Tezos API and Indexer
- Go — The language that powers the backend
🏛️ Tezos Ecosystem DAO
Community-voted, community-funded infrastructure for the Tezos ecosystem.
This project is supported by the Tezos community.
Made with 🦔💜 for the Tezos NFT community