Added content

This commit is contained in:
Phil 2022-01-27 17:10:20 +01:00
parent d548679c64
commit 54c9ab72f1
4 changed files with 68 additions and 38 deletions

View file

@ -4,44 +4,8 @@
An easy self-hosted Link shortener in Golang with Redis <3 [Live-Demo](https://gly.one)
---
## Supported architectures
### Docker
- amd64, arm64
- other versions can be build manually (via docker build / buildx)
## Binary Build
- linux (amd64,arm64)
- darwin (amd64,arm64)
- windows (amd64)
- other versions can be build manually (via go build)
---
**WARNING:**
- goshorly is in an early stage, it is not an Final Version! (Pre-Release Status v0.1.X)
If you have an feature request, please do not hesitate to open an issue or merge request.
Available Docker tags:
- https://git.ucode.space/Phil/goshorly/container_registry/1
## Install with Docker
Installation with Docker-Compose (with no reverse proxy / own proxy):
```bash
mkdir goshorly
cd goshorly
wget https://git.ucode.space/Phil/goshorly/-/raw/main/docker-compose.yml
nano docker-compose.yml # Change the environment variables to your needs
docker-compose up -d
```
Installation with Docker-Compose (built in proxy / caddy as reverse proxy):
```bash
mkdir goshorly
cd goshorly
wget https://git.ucode.space/Phil/goshorly/-/raw/main/docker-compose-proxy.yml
mv docker-compose-proxy.yml docker-compose.yml
nano docker-compose.yml # Change the command line on caddy to your domain & environment variables to your needs
docker-compose up -d
```
## Install with Binary version
- WIP

27
docs/deploy/binary.md Normal file
View file

@ -0,0 +1,27 @@
# Binary installation
## Download
Get the newest binary build from the package registry.
- https://git.ucode.space/Phil/goshorly/-/packages
## Get dependencies
To get goshorly running you need redis.
Installation guide for Windows:
- https://developer.redis.com/create/windows/
Installation guide for Linux:
- https://redis.io/topics/quickstart (compile guide)
- https://www.digitalocean.com/community/tutorials/how-to-install-and-secure-redis-on-ubuntu-20-04-de (ubuntu/debian)
Installation guide for Darwin/OSX:
- https://developer.redis.com/create/homebrew/
## Run
Just run the executable in a Powershell (windows) or Terminal (linux/darwin)
### Configuration
#### .env File
To use the binary version you need to create an .env file in the directory.
**This feature is coming soon**

23
docs/deploy/docker.md Normal file
View file

@ -0,0 +1,23 @@
# Docker installation
## Available Docker tags
- https://git.ucode.space/Phil/goshorly/container_registry/1
## docker-compose (with no reverse proxy)
```bash
mkdir goshorly
cd goshorly
wget https://git.ucode.space/Phil/goshorly/-/raw/main/docker-compose.yml
nano docker-compose.yml # Change the environment variables to your needs
docker-compose up -d
```
## docker-compose (with builtin reverse proxy)
```bash
mkdir goshorly
cd goshorly
wget https://git.ucode.space/Phil/goshorly/-/raw/main/docker-compose-proxy.yml
mv docker-compose-proxy.yml docker-compose.yml
nano docker-compose.yml # Change the command line on caddy to your domain & environment variables to your needs
docker-compose up -d
```

View file

@ -1,6 +1,22 @@
# Welcome to goshorly
![](https://git.ucode.space/Phil/goshorly/badges/main/pipeline.svg)
goshorly is an easy to use and self-hostable link shortener. It is based on the Golang programming language. Redis is used as the database.
If you have an feature request, please do not hesitate to open an issue or merge request.
**WARNING:**
- goshorly is in an early stage, it is not an Final Version! (Pre-Release Status v0.1.X)
## Disclaimer
This site is work in progress and does not contain the full docs.
## Supported architectures
### Docker
- amd64, arm64
- other versions can be build manually (via docker build / buildx)
### Binary Build
- linux (amd64,arm64)
- darwin (amd64,arm64)
- windows (amd64)
- other versions can be build manually (via go build)