Skip to content

Commit

Permalink
Merge pull request #3 from netfoundry/installation_script
Browse files Browse the repository at this point in the history
README for Installation
  • Loading branch information
jlin-nf authored Dec 16, 2024
2 parents 1cccbe6 + a73b0cf commit 55dc07b
Show file tree
Hide file tree
Showing 2 changed files with 85 additions and 3 deletions.
84 changes: 83 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1 +1,83 @@
# zfw-zet
# zfw-zet

## Installation

### Ubuntu

1. Install package via the installation script.

``` bash
curl -sSLf https://raw.githubusercontent.com/netfoundry/zfw-zet/refs/heads/main/files/install-zfw-zet.bash | bash
```

2. Enable and start the service

``` bash
sudo systemctl enable --now ziti-edge-tunnel.service
```

3. Add an Identity.

```
sudo ziti-edge-tunnel add --jwt "$(< ./in-file.jwt)" --identity myIdentityName
```

### Debian

| Debian Release | UBUNTU_LTS | Architecture |
| ---- | ---- | ---- |
| 13 Trixie | jammy | x86_64, arm64 |
| 12 Bookworm | jammy | x86_64, arm64 |
| 11 Bullseye | focal | x86_64, arm64 |

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.

``` bash
UBUNTU_LTS=focal
```

2. Install *gpg* package if not installed already.

``` bash
sudo apt update
sudo apt install --yes gnupg2
```

3. Subscribe the system to the OpenZiti package repository for the *UBUNTU_LTS* specified above.

``` bash
echo "deb [signed-by=/usr/share/keyrings/netfoundry-cloud.gpg] https://netfoundry.jfrog.io/artifactory/netfoundry-cloud-deb-stable ${UBUNTU_LTS} main" \
| sudo tee /etc/apt/sources.list.d/zfw.list >/dev/null
```

4. Install the package signing *pubkey*.

``` bash
curl -sSLf https://netfoundry.jfrog.io/artifactory/api/security/keypair/public/repositories/netfoundry-cloud-deb-stable \
| sudo gpg --dearmor --output /usr/share/keyrings/netfoundry-cloud.gpg
```

5. Ensure the *pubkey* is readable by all.

``` bash
sudo chmod a+r /usr/share/keyrings/netfoundry-cloud.gpg
```

6. Refresh the package list and install **zfw-zet**

``` bash
sudo apt update
sudo apt install --yes zfw-zet
```

7. Enable and start the service

``` bash
sudo systemctl enable --now ziti-edge-tunnel.service
```

8. Add an Identity.

```
sudo ziti-edge-tunnel add --jwt "$(< ./in-file.jwt)" --identity myIdentityName
```
4 changes: 2 additions & 2 deletions files/config.json
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
{
"version": "0.0.2"
}
"version": "0.0.3"
}

0 comments on commit 55dc07b

Please sign in to comment.