generated from DAM/ts-TEMPLATE
	init manual
This commit is contained in:
		
							parent
							
								
									d4cc045fa7
								
							
						
					
					
						commit
						740b1bf9ae
					
				
							
								
								
									
										48
									
								
								README.md
									
									
									
									
									
								
							
							
						
						
									
										48
									
								
								README.md
									
									
									
									
									
								
							| @ -1,8 +1,8 @@ | |||||||
| # {{Service}} with Tailscale Integration | # Minecraft with Tailscale Integration | ||||||
| 
 | 
 | ||||||
|  |  | ||||||
| 
 | 
 | ||||||
| This project sets up a {{Service}} instance with Tailscale VPN integration using Docker Compose. It creates a secure, private network connection for your {{Service}} instance using Tailscale. | This project sets up a Minecraft instance with Tailscale VPN integration using Docker Compose. It creates a secure, private network connection for your Minecraft instance using Tailscale. | ||||||
| 
 | 
 | ||||||
| ## Prerequisites | ## Prerequisites | ||||||
| 
 | 
 | ||||||
| @ -12,32 +12,32 @@ This project sets up a {{Service}} instance with Tailscale VPN integration using | |||||||
| 
 | 
 | ||||||
| ## Project Structure | ## Project Structure | ||||||
| ``` | ``` | ||||||
| ts-{{service}}/ | ts-minecraft/ | ||||||
| ├── docker-compose.yml | ├── docker-compose.yml | ||||||
| ├── tailscale/ | ├── tailscale/ | ||||||
| │   ├── tailscale-data/  # Persistent Tailscale state | │   ├── tailscale-data/  # Persistent Tailscale state | ||||||
| │   └── config/         # Tailscale configuration files | │   └── config/         # Tailscale configuration files | ||||||
| └── {{service}}/ | └── minecraft/ | ||||||
|     └── config/         # {{service}} configuration files |     └── data/         # minecraft data | ||||||
| ``` | ``` | ||||||
| 
 | 
 | ||||||
| ## Setup Instructions | ## Setup Instructions | ||||||
| 
 | 
 | ||||||
| 1. **Clone the Repository** | 1. **Clone the Repository** | ||||||
|    ```bash |    ```bash | ||||||
|    git clone https://gitea.damconsulting.llc/DAM/ts-{{service}} |    git clone https://gitea.damconsulting.llc/DAM/ts-minecraft | ||||||
|    cd ts-{{service}} |    cd ts-minecraft | ||||||
|    ``` |    ``` | ||||||
| 2. Create Required Directories | 2. Create Required Directories | ||||||
|     ```bash |     ```bash | ||||||
|     mkdir -p tailscale/tailscale-data |     mkdir -p tailscale/tailscale-data minecraft/data | ||||||
|     ``` |     ``` | ||||||
| 3. Configure Tailscale | 3. Configure Tailscale | ||||||
|     - Replace `{{YOUR_TAILSCALE_AUTHKEY}}` in the docker-compose.yml with your actual Tailscale auth key |     - Replace `{{YOUR_TAILSCALE_AUTHKEY}}` in the docker-compose.yml with your actual Tailscale auth key | ||||||
|     - Optionally, update the file in `tailscale/config/serve.json` if you need specific Tailscale serve configurations |     - Optionally, update the file in `tailscale/config/serve.json` if you need specific Tailscale serve configurations | ||||||
|         - CAUTION: Changing `"${TS_CERT_DOMAIN}:443": false` to `true` will expose the service to the internet |         - CAUTION: Changing `"${TS_CERT_DOMAIN}:443": false` to `true` will expose the service to the internet | ||||||
| 
 | 
 | ||||||
| 4. Configure {{Service}} | 4. Configure Minecraft | ||||||
|     - See {{service_docs}} for configuration options |     - See {{service_docs}} for configuration options | ||||||
| 
 | 
 | ||||||
| 5. Start the Services | 5. Start the Services | ||||||
| @ -51,26 +51,26 @@ ts-{{service}}/ | |||||||
| 
 | 
 | ||||||
| ## Services | ## Services | ||||||
| 
 | 
 | ||||||
| ### {{service}}-ts (Tailscale) | ### minecraft-ts (Tailscale) | ||||||
| 
 | 
 | ||||||
| - Runs Tailscale VPN client | - Runs Tailscale VPN client | ||||||
| - Image: tailscale/tailscale:latest | - Image: tailscale/tailscale:latest | ||||||
| - Container name: {{service}}-ts | - Container name: minecraft-ts | ||||||
| - Hostname: {{service}} | - Hostname: minecraft | ||||||
| - Requires NET_ADMIN and SYS_MODULE capabilities | - Requires NET_ADMIN and SYS_MODULE capabilities | ||||||
| - Persists state in ./tailscale/tailscale-data | - Persists state in ./tailscale/tailscale-data | ||||||
| - Uses configuration from ./tailscale/config | - Uses configuration from ./tailscale/config | ||||||
| 
 | 
 | ||||||
| ### {{service}} | ### minecraft | ||||||
| 
 | 
 | ||||||
| - Depends on {{service}}-ts service | - Depends on minecraft-ts service | ||||||
| 
 | 
 | ||||||
| ## Usage | ## Usage | ||||||
| 
 | 
 | ||||||
| - After starting the services your service should be available via tailnet at `https://{{service}}.{{YOUR_TAILNET_DOMAIN}}.ts.net` ie `https://{{service}}.tail12345.ts.net/` | - After starting the services your service should be available via tailnet at `https://minecraft.{{YOUR_TAILNET_DOMAIN}}.ts.net` ie `https://minecraft.tail12345.ts.net/` | ||||||
| - To manually get the Tailscale IP/hostname of your container: | - To manually get the Tailscale IP/hostname of your container: | ||||||
|     ```bash |     ```bash | ||||||
|     docker logs {{service}}-ts |     docker logs minecraft-ts | ||||||
|     ``` |     ``` | ||||||
|     Look for the Tailscale IP address in the logs. |     Look for the Tailscale IP address in the logs. | ||||||
| 
 | 
 | ||||||
| @ -79,7 +79,7 @@ ts-{{service}}/ | |||||||
| - Uncomment and adjust the ports mapping if you need direct access (without Tailscale): | - Uncomment and adjust the ports mapping if you need direct access (without Tailscale): | ||||||
|     ```yaml |     ```yaml | ||||||
|     ports: |     ports: | ||||||
|     - 3000:3000 |     - 25565:25565 | ||||||
|     ``` |     ``` | ||||||
| - Stopping the Services | - Stopping the Services | ||||||
|     ```bash |     ```bash | ||||||
| @ -89,19 +89,19 @@ ts-{{service}}/ | |||||||
| ## Troubleshooting | ## Troubleshooting | ||||||
| - Check container logs: | - Check container logs: | ||||||
|     ```bash |     ```bash | ||||||
|     docker logs {{service}}-ts |     docker logs minecraft-ts | ||||||
|     docker logs {{service}} |     docker logs minecraft | ||||||
|     ``` |     ``` | ||||||
| - Ensure your Tailscale auth key is valid and not expired | - Ensure your Tailscale auth key is valid and not expired | ||||||
| - Verify the configuration files have proper permissions | - Verify the configuration files have proper permissions | ||||||
| - Make sure required directories exist before starting | - Make sure required directories exist before starting | ||||||
| 
 | 
 | ||||||
| ## Notes | ## Notes | ||||||
| - The {{Service}} service uses the Tailscale service's network stack via `network_mode: service:{{service}}-ts` | - The Minecraft service uses the Tailscale service's network stack via `network_mode: service:minecraft-ts` | ||||||
| - Direct port mapping is disabled by default as Tailscale handles the networking | - Direct port mapping is disabled by default as Tailscale handles the networking | ||||||
| - Services restart automatically unless explicitly stopped | - Services restart automatically unless explicitly stopped | ||||||
|  | - For MODS there is an AWESOME tool for modifying a minecraft docker compose deployment. https://setupmc.com/java-server/ | ||||||
| - For more information: | - For more information: | ||||||
|     - Tailscale documentation: https://tailscale.com/kb/ |     - Tailscale documentation: https://tailscale.com/kb/ | ||||||
|     - {{Service}} documentation: {{service_docs}} |     - Minecraft documentation: https://docker-minecraft-server.readthedocs.io/en/latest/ | ||||||
|     - {{Service}} repository: {{service_repo}} |     - Minecraft repository: https://github.com/itzg/docker-minecraft-server | ||||||
|     - {{Service}} linuxserve.io: {{service_lcsr}} |  | ||||||
		Loading…
	
	
			
			x
			
			
		
	
		Reference in New Issue
	
	Block a user