valentin
/
ltsNinja
mirror of https://github.com/itsmrval/ltsNinja
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
Web interface to reduce long URLs to short extensions
23 Commits
1 Branch
2 Tags
10 MiB
HTML 58.4%
Go 41.6%
 
 
Go to file
Valentin f830345c82
no more domain 		2025-08-15 19:05:42 +02:00
src feat(struct) moving into src directory 2024-08-02 15:24:28 +02:00
.gitattributes feat(struct) moving into src directory 2024-08-02 15:24:28 +02:00
.gitignore fix(gitignore) removed build 2024-08-02 15:18:57 +02:00
LICENSE Initial commit 2024-07-10 13:54:19 +02:00
README.md no more domain 2025-08-15 19:05:42 +02:00

README.md


Logo

ltsNinja

Simple and lightwell url shortener running GO.

Report Bug · Pull request

Table of contents
  1. What is ltsNinja ?
  2. Getting started
  3. Roadmap
  4. License

What is ltsNinja

Homepage Dashboard

ltsNinja is a public, self-hosted tool that makes it easy to shorten urls. It's very lightweight and intuitive, which means it runs with very little performance.

Few key points:

  • Github login for custom links
  • Easy dashboard for users

(back to top)

Built With

This section list major frameworks/libraries used

(back to top)

Getting Started

Now let's see how to set up an ltsNinja instance.

Installation

  1. Create directory

    mkdir /opt/ltsNinja
cd /opt/ltsNinja

  2. Download the latest release and apply permissions

    wget -O ltsNinja https://github.com/itsmrval/ltsNinja/releases/download/0.1.1/ltsNinja_linux_amd64
chmod +x ltsNinja

  3. Create the service on systemd Write the file

    nano /etc/systemd/system/ltsNinja.service

    Complete and put the service file below:

    [Unit]
Description=LTS Ninja service
After=network.target

[Service]
Type=simple
ExecStart=/opt/ltsNinja/ltsNinja
Environment="GITHUB_CLIENT_ID=<REPLACE HERE>"
Environment="GITHUB_CLIENT_SECRET=<REPLACE HERE>"
Environment="GITHUB_REDIRECT_URL=https://<REPLACE HERE>/callback"
Environment="DB_PATH=/opt/ltsNinja/database.db"
Environment="PORT=8080"

[Install]
WantedBy=multi-user.target

  4. Reload systemd and run the service !

    systemctl daemon-reload
systemctl enable --now ltsNinja

(back to top)

Roadmap

  • URL Shortener
  • Custom links
  • User dashboard
  • Edit with github
  • Admin dashboard

(back to top)

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)