Skip to main content
Prerequisites for system:
  • Minimum 2Ghz or high cpu+
  • Minimum 5GB of disk
  • Minimum 2GB of Random Access Memory (RAM)
Follow these steps to install and run Lightd on your system.

Install The Rust Programming Language

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
2

Run cargo install to check if Rust is available on the machine

Navigate to your docs directory where lightd was cloned and run.
cargo build
3

Use the make file or cargo to run the project.

cargo run
You should see an output like this
Finished `dev` profile [unoptimized + debuginfo] target(s) in 17.35s
Running `target/debug/lightd`
2026-01-11T04:44:50.150690Z  INFO lightd::network_config: Loaded network configuration from network.json
      
    __    _       __    __      __
   / /   (_)___ _/ /_  / /_____/ /
  / /   / / __ `/ __ \/ __/ __  / 
 / /___/ / /_/ / / / / /_/ /_/ /  
/_____/_/\__, /_/ /_/\__/\__,_/   
        /____/                           
                                                          
Lightd Daemon v0.1.0
(c) 2025-present Nadhi.dev

2026-01-11T04:44:50.150984Z  INFO lightd: Tokio runtime configured with 24 worker threads
2026-01-11T04:44:51.841387Z  INFO lightd::docker::client: Successfully connected to Docker daemon
2026-01-11T04:44:51.873090Z  INFO lightd::container_tracker: Container tracking storage initialized at: ./storage/containers
2026-01-11T04:44:51.913496Z  INFO lightd::docker::network: Restored 16 port allocations from container data
2026-01-11T04:44:51.922166Z  INFO lightd::state_manager: Loaded existing daemon state from: ./storage/states.json
2026-01-11T04:44:51.922554Z  INFO lightd: Starting daemon recovery process...
2026-01-11T04:44:51.945959Z  INFO lightd::state_manager: Updated container 26a20ca1-fbc1-42e3-ba5a-1b65e42b10a4 state to: stopped
2026-01-11T04:44:51.945983Z  INFO lightd::state_manager: Updated container b6b5c912-5b6b-4c3e-9a00-c45db7ce1655 state to: stopped
2026-01-11T04:44:51.945989Z  INFO lightd::state_manager: Updated container 73b9c7aa-b235-44d1-bad8-2f84e929b311 state to: stopped

​
Building with MakeFiles

Lightd comes with a MakeFile in default. This allows developers and power users to test lightd faster. Make sure your system supports MakeFiles before we start.

​
Running lightd with the MakeFile

make run
Now you have installed Lightd, but let’s learn how to use it! See the Lightd API docs