LaunchPort

A centralized dashboard for managing apps routed through a reverse proxy.

🚀 What is LaunchPort

LaunchPort simplifies access and management of your applications by providing a user-friendly control dashboard.
When paired with a reverse proxy like SWAG, LaunchPort handles requests to inactive applications by redirecting users to a dedicated control page.

---

📦 Installation

LaunchPort can be installed using Docker.

1. Download the docker-compose.yaml file here.
2. Edit the docker-compose.yaml file and change the environment variables to your liking.
3. Run docker-compose up -d in the same directory as the docker-compose.yaml file.
4. Open your browser and navigate to http://localhost:3000.

Environment Variable	Description
DATABASE_URL	The database URL in the format: postgresql://user:password@host:port/database?schema=public
AUTH_URL	The URL for accessing LaunchPort.
AUTH_SECRET	A secret used for authentication purposes.

🔗 Configuring the Reverse Proxy

To allow LaunchPort to redirect requests, you must configure your Reverse Proxy so that it redirects
users to your LaunchPort instance in case of a Bad Gateway error. If you are using SWAG / Nginx you can follow these steps:

1. Create a file launchport.conf

error_page 502 =302 https://launchport.example.com/redirect?origin=$target_url;

2. For each site you want LaunchPort to cover, include the created file in the location block.

location / {
	# LaunchPort
	include /config/nginx/launchport.conf;
	
	# enable the next two lines for http auth
	#auth_basic "Restricted";
	#auth_basic_user_file /config/nginx/.htpasswd;

	#...
}

---

📸 Screenshots

---

Note

This project is my first public project and I am still learning a long the way.
Feel free to contribute by fixing bugs, adding new features, improving the code quality
and help make LaunchPort better for everyone!