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 | ||||
| 
 | ||||
| @ -12,32 +12,32 @@ This project sets up a {{Service}} instance with Tailscale VPN integration using | ||||
| 
 | ||||
| ## Project Structure | ||||
| ``` | ||||
| ts-{{service}}/ | ||||
| ts-minecraft/ | ||||
| ├── docker-compose.yml | ||||
| ├── tailscale/ | ||||
| │   ├── tailscale-data/  # Persistent Tailscale state | ||||
| │   └── config/         # Tailscale configuration files | ||||
| └── {{service}}/ | ||||
|     └── config/         # {{service}} configuration files | ||||
| └── minecraft/ | ||||
|     └── data/         # minecraft data | ||||
| ``` | ||||
| 
 | ||||
| ## Setup Instructions | ||||
| 
 | ||||
| 1. **Clone the Repository** | ||||
|    ```bash | ||||
|    git clone https://gitea.damconsulting.llc/DAM/ts-{{service}} | ||||
|    cd ts-{{service}} | ||||
|    git clone https://gitea.damconsulting.llc/DAM/ts-minecraft | ||||
|    cd ts-minecraft | ||||
|    ``` | ||||
| 2. Create Required Directories | ||||
|     ```bash | ||||
|     mkdir -p tailscale/tailscale-data | ||||
|     mkdir -p tailscale/tailscale-data minecraft/data | ||||
|     ``` | ||||
| 3. Configure Tailscale | ||||
|     - 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 | ||||
|         - 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 | ||||
| 
 | ||||
| 5. Start the Services | ||||
| @ -51,26 +51,26 @@ ts-{{service}}/ | ||||
| 
 | ||||
| ## Services | ||||
| 
 | ||||
| ### {{service}}-ts (Tailscale) | ||||
| ### minecraft-ts (Tailscale) | ||||
| 
 | ||||
| - Runs Tailscale VPN client | ||||
| - Image: tailscale/tailscale:latest | ||||
| - Container name: {{service}}-ts | ||||
| - Hostname: {{service}} | ||||
| - Container name: minecraft-ts | ||||
| - Hostname: minecraft | ||||
| - Requires NET_ADMIN and SYS_MODULE capabilities | ||||
| - Persists state in ./tailscale/tailscale-data | ||||
| - Uses configuration from ./tailscale/config | ||||
| 
 | ||||
| ### {{service}} | ||||
| ### minecraft | ||||
| 
 | ||||
| - Depends on {{service}}-ts service | ||||
| - Depends on minecraft-ts service | ||||
| 
 | ||||
| ## 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: | ||||
|     ```bash | ||||
|     docker logs {{service}}-ts | ||||
|     docker logs minecraft-ts | ||||
|     ``` | ||||
|     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): | ||||
|     ```yaml | ||||
|     ports: | ||||
|     - 3000:3000 | ||||
|     - 25565:25565 | ||||
|     ``` | ||||
| - Stopping the Services | ||||
|     ```bash | ||||
| @ -89,19 +89,19 @@ ts-{{service}}/ | ||||
| ## Troubleshooting | ||||
| - Check container logs: | ||||
|     ```bash | ||||
|     docker logs {{service}}-ts | ||||
|     docker logs {{service}} | ||||
|     docker logs minecraft-ts | ||||
|     docker logs minecraft | ||||
|     ``` | ||||
| - Ensure your Tailscale auth key is valid and not expired | ||||
| - Verify the configuration files have proper permissions | ||||
| - Make sure required directories exist before starting | ||||
| 
 | ||||
| ## 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 | ||||
| - 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: | ||||
|     - Tailscale documentation: https://tailscale.com/kb/ | ||||
|     - {{Service}} documentation: {{service_docs}} | ||||
|     - {{Service}} repository: {{service_repo}} | ||||
|     - {{Service}} linuxserve.io: {{service_lcsr}} | ||||
|     - Minecraft documentation: https://docker-minecraft-server.readthedocs.io/en/latest/ | ||||
|     - Minecraft repository: https://github.com/itzg/docker-minecraft-server | ||||
		Loading…
	
	
			
			x
			
			
		
	
		Reference in New Issue
	
	Block a user