|
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 | +``` |
0 commit comments