2023-08-20 21:26:55 +00:00
---
2023-08-20 21:35:06 +00:00
title: Debian Install
description: How to install `veilid-server` and `veilid-cli` on Debian based systems
weight: 3
2023-08-20 21:26:55 +00:00
layout: subpage
---
2023-08-20 21:35:06 +00:00
### Step 1
2023-08-20 21:26:55 +00:00
2023-08-20 22:29:56 +00:00
Add the GPG keys to your operating systems keyring.
_Explanation_: The wget command downloads the public key, and the sudo gpg command adds the public key to the keyring.
2023-08-20 21:26:55 +00:00
2023-08-20 21:35:06 +00:00
< div class = "code-snippet" >
< input aria-label = "Get Keys" type = "text" readonly value = "wget -O- https://packages.veilid.net/gpg/veilid-packages-key.public | sudo gpg --dearmor -o /usr/share/keyrings/veilid-packages-keyring.gpg" >
< button class = "btn btn-secondary" > < span > Copy< / span > < / button >
< / div >
2023-08-20 21:26:55 +00:00
2023-08-20 21:35:06 +00:00
### Step 2
2023-08-20 21:26:55 +00:00
2023-08-20 22:29:56 +00:00
Identify your architecture
_Explanation_: The following command will tell you what type of CPU your system is running
2023-08-20 21:26:55 +00:00
2023-08-20 21:35:06 +00:00
< div class = "code-snippet" >
2023-08-20 22:29:56 +00:00
< input aria-label = "Add Keys" type = "text" readonly value = 'dpkg --print-architecture' >
2023-08-20 21:35:06 +00:00
< button class = "btn btn-secondary" > < span > Copy< / span > < / button >
< / div >
2023-08-20 21:26:55 +00:00
2023-08-20 21:35:06 +00:00
### Step 3
2023-08-20 21:26:55 +00:00
2023-08-20 22:29:56 +00:00
Add Veilid to your list of available software.
_Explanation_: Using the command in Step 2 you will need to run one of the following:
- For **AMD**64 based systems run this command:
2023-08-20 21:26:55 +00:00
2023-08-20 21:35:06 +00:00
< div class = "code-snippet" >
2023-08-20 22:29:56 +00:00
< input aria-label = "Add Keys" type = "text" readonly value = 'echo "deb [arch=amd64 signed-by=/usr/share/keyrings/veilid-packages-keyring.gpg] https://packages.veilid.net/apt stable main" | sudo tee /etc/apt/sources.list.d/veilid.list 1>/dev/null' >
< button class = "btn btn-secondary" > < span > Copy< / span > < / button >
< / div >
- For **ARM**64 based systems run this command:
< div class = "code-snippet" >
2023-08-20 22:40:52 +00:00
< input aria-label = "Add Keys" type = "text" readonly value = 'echo "deb [arch=arm64 signed-by=/usr/share/keyrings/veilid-packages-keyring.gpg] https://packages.veilid.net/apt stable main" | sudo tee /etc/apt/sources.list.d/veilid.list 1>/dev/null' >
2023-08-20 21:35:06 +00:00
< button class = "btn btn-secondary" > < span > Copy< / span > < / button >
< / div >
2023-08-20 21:26:55 +00:00
2023-08-20 22:29:56 +00:00
_Explanation_: Each of the above commands will create a new file called `veilid.list` in the `/etc/apt/sources.list.d/` . This file contains instructions that tell the operating system where to download Veilid.
2023-08-20 21:35:06 +00:00
### Step 4
2023-08-20 21:26:55 +00:00
2023-08-20 22:29:56 +00:00
Refresh the package manager.
_Explanation_: This tells the `apt` package manager to rebuild the list of available software using the files in `/etc/apt/sources.list.d/` directory
< div class = "code-snippet" >
< input aria-label = "Run Updates" type = "text" readonly value = "apt update" >
< button class = "btn btn-secondary" > < span > Copy< / span > < / button >
< / div >
#### Step 5
Install Veilid.
_Explanation_: With the package manager updated, it is now possible to install Veilid!
2023-08-20 21:26:55 +00:00
2023-08-20 21:35:06 +00:00
< div class = "code-snippet" >
< input aria-label = "Install the headless and command line utilities" type = "text" readonly value = "apt install veilid-server veilid-cli" >
< button class = "btn btn-secondary" > < span > Copy< / span > < / button >
< / div >
2023-08-20 21:26:55 +00:00
2023-08-20 22:29:56 +00:00
< hr / >
The remaining steps are optional.
### Step 6
2023-08-20 21:26:55 +00:00
2023-08-20 21:35:06 +00:00
Start `veilid-server.service` manually
2023-08-20 21:26:55 +00:00
2023-08-20 21:35:06 +00:00
< div class = "code-snippet" >
< input aria-label = "Install the headless and command line utilities" type = "text" readonly value = "sudo systemctl start veilid-server.service" >
< button class = "btn btn-secondary" > < span > Copy< / span > < / button >
< / div >
2023-08-20 21:26:55 +00:00
2023-08-20 22:29:56 +00:00
### Step 7
2023-08-20 21:26:55 +00:00
2023-08-20 21:35:06 +00:00
Set up `veilid-server.service` to start at boot
2023-08-20 21:26:55 +00:00
2023-08-20 21:35:06 +00:00
< div class = "code-snippet" >
< input aria-label = "Install the headless and command line utilities" type = "text" readonly value = "sudo systemctl enable --now veilid-server.service" >
< button class = "btn btn-secondary" > < span > Copy< / span > < / button >
< / div >
2023-08-20 21:26:55 +00:00