26 lines
1.3 KiB
Markdown
26 lines
1.3 KiB
Markdown
# Shlink
|
||
|
||
Shlink is a fast self-hosted URL shortener that offers a RESTful API and a command line interface. Your shortened links are also safely manageable through [app.shlink.io](https://app.shlink.io) which is 100% browser based. Notable features include custom slugs, click tracking, and tag management.
|
||
|
||
Please note that the following advanced features are not activated through this Tipi App:
|
||
* Multi-domain support
|
||
* Geo-Localisation
|
||
* RabbitMQ/Mercure real-time updates
|
||
|
||
During the installation process, you will be prompted to specify the domain for your shortened URLs.
|
||
|
||
## ℹ️ Required post installation step
|
||
After installing Shlink in Tipi, you will have to generate a API Key before being able to use the service through the following command.
|
||
```bash
|
||
docker exec -it shlink shlink api-key:generate
|
||
```
|
||
|
||
Keep your API Key secure, as it is essential for link administration. If you lose the key, rerun the command to generate a new one.
|
||
|
||
If you don't have access to the console of your Tipi server, consider using Portainer which is available on Tipi. Within Portainer, you would have to:
|
||
* Select the local environment
|
||
* Select the shlink container - not the shlink-db -
|
||
* Click on Console within the "Container Status" panel
|
||
* Execute a /bin/sh command
|
||
* Within the newly opened terminal, enter `shlink api-key:generate`
|