Skip to content
This repository has been archived by the owner on Oct 2, 2023. It is now read-only.
/ citadel Public archive

Citadel - free and open-source Lightning node and home server

Notifications You must be signed in to change notification settings

runcitadel/citadel

Repository files navigation

Citadel

Citadel allows you to run your own Bitcoin Lightning node and personal server. It is proudly free and open-source software. Anyone is free to use, copy, study and change the software in any way as well as distribute it for commercial purposes.

Our mission

We aim to provide secure nodes and servers for everyone where you are in control of your data, not a big company. We make contributions to various open source projects used on Citadel to make sure we're giving back to the community we build on.

Overview

💡 Have an idea for a feature? Discuss a topic

⁉ Something isn't working? Create an issue

💬 Need help getting started? Telegram / Discord

🗞️ Stay up to date: Twitter / Blog

📚 Find guides & best practices: Wiki

Installation

There are many ways to install Citadel. Depending on your hardware and operating system you can follow one of the below step-by-step guides to get started.

Raspberry Pi 4: runcitadel.space/setup

Debian / Ubuntu: runcitadel.space/x86

Migrate from Umbrel: runcitadel.space/migrate

Docker + Sysbox (experimental): github.com/runcitadel/citadel-dev

Citadel vs. Umbrel

Citadel is a mostly open source and soon to be fully FLOSS Lightning Node implementation based on Umbrel. Most of the codebase has been rewritten and moved away from Umbrel. Citadel offers many improvements over Umbrel:

  • faster operating system optimized for Raspberry Pi
  • independent and therefore faster app updates
  • our own, up-to-date user interface with built-in dark mode
  • listening node by default

Roadmap

Citadel is fully transparent and built by the community. To see milestones and follow current development view the project board.

Repositories

Name Description
citadel This overview, issues, discussions and project management
core The core of Citadel
dashboard Current frontend
middleware Communication with bitcoin & lightning implementations
manager Manages containers, authentication & misc.
sdk Library to connect applications to Citadel
apps Free, open source apps available on Citadel
citadel-dev CLI tool to spin up instances of Citadel in a Docker container

Contributing

We welcome and appreciate new contributions! The best way to get started is to reach out to us on Telegram.

License

Citadel is licensed under the GNU Affero General Public License v3.0 or later.

It includes code from umbrel-os and pi-gen, which are

Copyright (c) 2015 Raspberry Pi (Trading) Ltd.
Copyright (c) 2020 Umbrel. https://getumbrel.com/

Additionally, the current dashboard contains code from Casa and Umbrel.


"Being open source means anyone can independently review the code. If it was closed source, nobody could verify the security. I think it's essential for a program of this nature to be open source." — Satoshi Nakamoto

License: AGPL-3.0

About

Citadel - free and open-source Lightning node and home server

Topics

Resources

Stars

Watchers

Forks

Contributors 4

  •  
  •  
  •  
  •