Skip to content

Commit 84f8784

Browse files
committed
Prepare v0.3.0 release documentation
- Bump runtime/container version to v0.3.0 - Add v0.3.0 changelog entry for new features - Add v0.3.0 release notes document - Update README release notes list - Tests not run (not requested)
1 parent e15d59f commit 84f8784

File tree

5 files changed

+134
-2
lines changed

5 files changed

+134
-2
lines changed

AGENTS.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -202,7 +202,7 @@ Fast iteration without rebuilding the full image:
202202

203203
## Version Information
204204

205-
- Container version: `v0.2.1` (see `start.sh` and release notes)
205+
- Container version: `v0.3.0` (see `start.sh` and release notes)
206206
- Tailscale base: `v1.92.5` (Dockerfile ARG)
207207
- Go version: `1.21` (Dockerfile ARG)
208208

CHANGELOG.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,21 @@ All notable changes to tailrelay will be documented in this file.
55
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
66
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
77

8+
## [v0.3.0] - 2026-02-01
9+
10+
### Added
11+
- Live log streaming in the Web UI with a comprehensive logging system
12+
- Custom CA certificate upload support for TLS-validated upstream proxies
13+
- Local Web UI development workflow for faster iteration
14+
15+
### Changed
16+
- Aligned Caddy proxy route structure for consistent configuration
17+
- Persisted Caddy server mappings per proxy to reduce configuration churn
18+
- Refactored proxy manager and related configuration handling
19+
20+
### Removed
21+
- Legacy proxy file handling (file-based proxy management)
22+
823
## [v0.2.0] - 2026-01-26
924

1025
### Added

README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -371,6 +371,7 @@ See [Development](#development) section for WebUI development workflow.
371371

372372
## Release Notes
373373

374+
- [v0.3.0](docs/release-notes/RELEASE_NOTES_v0.3.0.md) - Logging, custom CA certs, and proxy management improvements
374375
- [v0.2.1](docs/release-notes/RELEASE_NOTES_v0.2.1.md) - Caddy API integration
375376
- [v0.2.0](docs/release-notes/RELEASE_NOTES_v0.2.0.md) - Web UI release
376377

Lines changed: 116 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,116 @@
1+
````markdown
2+
# Release Notes - v0.3.0
3+
4+
**Release Date:** February 1, 2026
5+
6+
## 🚀 Highlights
7+
8+
This release focuses on stronger observability and more robust proxy management:
9+
- Live log streaming in the Web UI
10+
- Custom CA certificate uploads for TLS-verified upstreams
11+
- More consistent and stable Caddy proxy configuration handling
12+
13+
## ✨ Key Features
14+
15+
### Web UI Logging (Live Streaming)
16+
- Comprehensive logging system added to the Web UI
17+
- Live streaming of logs to the browser for faster troubleshooting
18+
- Improved visibility into proxy, relay, and service activity
19+
20+
### Custom CA Certificate Uploads
21+
- Upload custom CA certificates for upstream TLS verification
22+
- Enables secure connections to services using internal or private PKI
23+
- Reduces the need for insecure TLS bypasses
24+
25+
### Proxy Management Improvements
26+
- Aligned Caddy route structure for consistent configuration output
27+
- Persisted server mappings per proxy to minimize churn
28+
- Refactored proxy manager for clearer configuration handling
29+
30+
## 🔧 Technical Changes
31+
32+
### Added
33+
- Logging subsystem with live-streaming endpoints in the Web UI
34+
- Custom CA certificate upload pipeline for proxy TLS
35+
- Local Web UI development workflow for rapid iteration
36+
37+
### Changed
38+
- Caddy route generation to maintain consistent proxy structure
39+
- Caddy server mappings stored per proxy for stability
40+
- Internal proxy manager refactors to match new configuration flows
41+
42+
### Removed
43+
- Legacy file-based proxy handling (Caddyfile/JSON-based proxy CRUD)
44+
45+
## 📦 Upgrade Instructions
46+
47+
### Docker Users
48+
49+
```bash
50+
# Pull the latest image
51+
docker pull sudocarlos/tailrelay:v0.3.0
52+
# or
53+
docker pull sudocarlos/tailrelay:latest
54+
55+
# Restart your container
56+
docker restart tailrelay
57+
```
58+
59+
### Start9 Users
60+
61+
1. Stop the current container:
62+
```bash
63+
sudo podman stop start9.tailscale
64+
sudo podman rm start9.tailscale
65+
```
66+
2. Pull the new version:
67+
```bash
68+
sudo podman pull docker.io/sudocarlos/tailrelay:v0.3.0
69+
```
70+
3. Start with the same configuration:
71+
```bash
72+
sudo podman run --name start9.tailscale \
73+
-v /home/start9/tailscale/:/var/lib/tailscale \
74+
-e TS_HOSTNAME=start9 \
75+
-p 8021:8021 \
76+
--net start9 \
77+
docker.io/sudocarlos/tailrelay:v0.3.0
78+
```
79+
80+
## 🔍 Verification
81+
82+
After upgrading, verify the new features:
83+
84+
```bash
85+
# Web UI health (should load and show logs)
86+
curl http://localhost:8021
87+
88+
# Caddy config routes
89+
tailrelay_caddy_routes=$(curl -s http://localhost:2019/config/apps/http/servers/tailrelay/routes)
90+
echo "$tailrelay_caddy_routes" | jq
91+
```
92+
93+
## ⚠️ Notes
94+
95+
- Proxy configuration is now fully API-driven; legacy file-based proxy handling has been removed.
96+
- If you use a private CA for upstream TLS, upload it through the Web UI before enabling verification.
97+
98+
## 📝 Changelog
99+
100+
### Added
101+
- Live log streaming in the Web UI
102+
- Custom CA certificate upload support for upstream TLS verification
103+
- Local Web UI development workflow
104+
105+
### Changed
106+
- Consistent Caddy proxy route structure
107+
- Persisted Caddy server mappings per proxy
108+
- Refactored proxy manager and configuration handling
109+
110+
### Removed
111+
- Legacy proxy file handling
112+
113+
---
114+
115+
**Full Changelog**: https://github.com/sudocarlos/tailscale-socaddy-proxy/compare/v0.2.1...v0.3.0
116+
````

start.sh

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
#!/bin/ash
22
trap 'kill -TERM $PID' TERM INT
3-
TAILRELAY_VERSION=v0.2.1
3+
TAILRELAY_VERSION=v0.3.0
44

55
# Accept a single comma‑separated list of port:target pairs
66
# Each item in the list represents one socat relay

0 commit comments

Comments
 (0)