Skip to content

Commit 55dc07b

Browse files
authored
Merge pull request #3 from netfoundry/installation_script
README for Installation
2 parents 1cccbe6 + a73b0cf commit 55dc07b

File tree

2 files changed

+85
-3
lines changed

2 files changed

+85
-3
lines changed

README.md

Lines changed: 83 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,83 @@
1-
# zfw-zet
1+
# zfw-zet
2+
3+
## Installation
4+
5+
### Ubuntu
6+
7+
1. Install package via the installation script.
8+
9+
``` bash
10+
curl -sSLf https://raw.githubusercontent.com/netfoundry/zfw-zet/refs/heads/main/files/install-zfw-zet.bash | bash
11+
```
12+
13+
2. Enable and start the service
14+
15+
``` bash
16+
sudo systemctl enable --now ziti-edge-tunnel.service
17+
```
18+
19+
3. Add an Identity.
20+
21+
```
22+
sudo ziti-edge-tunnel add --jwt "$(< ./in-file.jwt)" --identity myIdentityName
23+
```
24+
25+
### Debian
26+
27+
| Debian Release | UBUNTU_LTS | Architecture |
28+
| ---- | ---- | ---- |
29+
| 13 Trixie | jammy | x86_64, arm64 |
30+
| 12 Bookworm | jammy | x86_64, arm64 |
31+
| 11 Bullseye | focal | x86_64, arm64 |
32+
33+
1. Refer to the table to find the Ubuntu release name that is the contemporary of the Debian release. Substitute the Ubuntu release name for **focal** for the definition below.
34+
35+
``` bash
36+
UBUNTU_LTS=focal
37+
```
38+
39+
2. Install *gpg* package if not installed already.
40+
41+
``` bash
42+
sudo apt update
43+
sudo apt install --yes gnupg2
44+
```
45+
46+
3. Subscribe the system to the OpenZiti package repository for the *UBUNTU_LTS* specified above.
47+
48+
``` bash
49+
echo "deb [signed-by=/usr/share/keyrings/netfoundry-cloud.gpg] https://netfoundry.jfrog.io/artifactory/netfoundry-cloud-deb-stable ${UBUNTU_LTS} main" \
50+
| sudo tee /etc/apt/sources.list.d/zfw.list >/dev/null
51+
```
52+
53+
4. Install the package signing *pubkey*.
54+
55+
``` bash
56+
curl -sSLf https://netfoundry.jfrog.io/artifactory/api/security/keypair/public/repositories/netfoundry-cloud-deb-stable \
57+
| sudo gpg --dearmor --output /usr/share/keyrings/netfoundry-cloud.gpg
58+
```
59+
60+
5. Ensure the *pubkey* is readable by all.
61+
62+
``` bash
63+
sudo chmod a+r /usr/share/keyrings/netfoundry-cloud.gpg
64+
```
65+
66+
6. Refresh the package list and install **zfw-zet**
67+
68+
``` bash
69+
sudo apt update
70+
sudo apt install --yes zfw-zet
71+
```
72+
73+
7. Enable and start the service
74+
75+
``` bash
76+
sudo systemctl enable --now ziti-edge-tunnel.service
77+
```
78+
79+
8. Add an Identity.
80+
81+
```
82+
sudo ziti-edge-tunnel add --jwt "$(< ./in-file.jwt)" --identity myIdentityName
83+
```

files/config.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
11
{
2-
"version": "0.0.2"
3-
}
2+
"version": "0.0.3"
3+
}

0 commit comments

Comments
 (0)