wneessen/apg-go
1
1
Fork 0
mirror of https://github.com/wneessen/apg-go.git synced 2024-11-21 21:30:51 +01:00
Code Issues Projects Releases Packages Wiki Activity

Merge pull request #94 from wneessen/feature/93_installation-documentation-should-include-go-install-instructions

Browse source 
Add Go install instructions to README
This commit is contained in:
Winni Neessen 2024-03-26 09:55:41 +01:00 committed by GitHub
commit d302625908
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 30 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

30
README.md
View file

@ -71,6 +71,36 @@ There is a ready-to-use Docker image hosted on Github.
```shell
$ docker run ghcr.io/wneessen/apg-go:main
```
### Go install
apg-go can be installed using the `go install` command if you have Go installed on your system. This requires
that you have Go installed on your system and that your Go version matches or is higher than the version
required in `go.mod`. You can install various versions using `go install`.
* Verify your Go version
```shell
$ go version
go version go1.22.1 linux/amd64
```
**Note: Make sure that your Go version matches the requirements of apg-go.**
* Install the latest version of apg-go
```shell
$ go install github.com/wneessen/apg-go/cmd/apg@latest
```
The `latest` tag will always install the latest release. If you want to run a different version you can replace
the `latest` with the requested version (i. e. `v1.1.0`). Alternatively if you want to test the latest code, not
fully released code from the main branch, you can replace `latest` with `main`.
* Execute apg-go
Once the `go install` command completed without errors, your apg-go binary will be installed into your Go project
workspace or your `$GOPATH/bin` directory (i. e. `/home/ttester/go/bin`). If this directory is
part of your `$PATH` environment, you can just execute it via the `apg` command, otherwise you'll need to
specify the full path: `/home/ttester/go/bin/apg`.
```shell
$ /home/ttester/go/bin/apg -v
apg-go // A "Automated Password Generator"-clone v1.2.0
OS: linux // Arch: amd64
(C) 2021-2024 by Winni Neessen
```
### Binary releases/Packages
On the [Github release page](https://github.com/wneessen/apg-go/releases) you will always find pre-build binaries