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`
							 |