https://github.com/ngn13/kisalt

simple link shortener
https://github.com/ngn13/kisalt

link-shortener link-shortener-api url-shortener

Last synced: 6 months ago
JSON representation

simple link shortener

• Host: GitHub
• URL: https://github.com/ngn13/kisalt
• Owner: ngn13
• License: gpl-3.0
• Created: 2024-02-02T19:52:38.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-03-30T08:54:51.000Z (7 months ago)
• Last Synced: 2025-03-30T09:27:52.283Z (7 months ago)
• Topics: link-shortener, link-shortener-api, url-shortener
• Language: C++
• Homepage: https://k.ngn.tf
• Size: 30.3 KB
• Stars: 3
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

          
# kisalt | simple link shortener

![](https://img.shields.io/github/license/ngn13/kisalt)

![](https://img.shields.io/github/repo-size/ngn13/kisalt)

![](https://img.shields.io/github/actions/workflow/status/ngn13/kisalt/publish.yml)

kisalt is a dead simple link shortener written with in C++ using the [Crow](https://github.com/CrowCpp/Crow) web framework.

### Deploy

You can easily deploy the app with docker and place it behind a proxy:

```bash

docker run -d --restart=unless-stopped \

     -p 127.0.0.1:8080:8080            \

     -e URL=https://k.example.com      \

     -v $PWD/data:/data                \

     ghcr.io/ngn13/kisalt

```

Change the `URL` accordingly. 

To disable the saving the links, you can use the `NOSAVE` option.

A volume is not needed when using this option:

```bash

docker run -d --restart=unless-stopped \

    -p 127.0.0.1:8080:8080             \

    -e URL=https://k.example.com       \

    -e NOSAVE=1                        \

    ghcr.io/ngn13/kisalt

```

### Usage

You can use the web interface to shorten links, or you can directly use the API:

```bash

curl https://k.example.com/add\?url=

```