Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/einseli/launchport
A centralized dashboard for managing apps routed through a reverse proxy.
https://github.com/einseli/launchport
docker nextjs reverse-proxy self-hosted
Last synced: 1 day ago
JSON representation
A centralized dashboard for managing apps routed through a reverse proxy.
- Host: GitHub
- URL: https://github.com/einseli/launchport
- Owner: EinsEli
- License: mit
- Created: 2025-01-26T22:05:47.000Z (3 days ago)
- Default Branch: main
- Last Pushed: 2025-01-26T23:36:26.000Z (3 days ago)
- Last Synced: 2025-01-27T00:22:19.016Z (3 days ago)
- Topics: docker, nextjs, reverse-proxy, self-hosted
- Language: TypeScript
- Homepage:
- Size: 1.87 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
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](https://docs.linuxserver.io/images/docker-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](docker-compose.yaml).
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`](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`
```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.
```conf
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!