blob: 89d2bc65a2c80350af121fbd780b93ee70ba2c2a (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
|
# Deployment Guide
Deploy Task Dashboard to a VPS using Apache2 as reverse proxy and Systemd for process management.
## Prerequisites
- Linux VPS (Ubuntu/Debian recommended)
- Apache2 with `mod_proxy`, `mod_proxy_http`, `mod_ssl`, `mod_headers`, `mod_rewrite`
- Go 1.21+ (for building)
- SSL certificate (Let's Encrypt recommended)
## Directory Structure
```
/site/{fqdn}/
├── app # Compiled binary
├── data/
│ └── dashboard.db # SQLite database
├── public/ # Static assets (served by Apache)
│ ├── css/
│ └── js/
├── templates/ # HTML templates
└── .env # Environment configuration
```
## Build
On your development machine or CI:
```bash
# Build for Linux
GOOS=linux GOARCH=amd64 go build -o app cmd/dashboard/main.go
```
## Setup
### 1. Create Directory Structure
```bash
export FQDN="your-domain.com"
sudo mkdir -p /site/${FQDN}/{data,public,templates}
sudo chown -R www-data:www-data /site/${FQDN}
```
### 2. Deploy Files
```bash
# Copy binary
sudo cp app /site/${FQDN}/
# Copy static assets
sudo cp -r web/static/* /site/${FQDN}/public/
# Copy templates
sudo cp -r web/templates/* /site/${FQDN}/templates/
# Set permissions
sudo chmod +x /site/${FQDN}/app
```
### 3. Configure Environment
Create `/site/${FQDN}/.env`:
```bash
# Required API Keys
TODOIST_API_KEY=your_todoist_api_key
TRELLO_API_KEY=your_trello_api_key
TRELLO_TOKEN=your_trello_token
# Optional
PLANTOEAT_API_KEY=your_plantoeat_api_key
# Paths (adjust for deployment structure)
DATABASE_PATH=/site/${FQDN}/data/dashboard.db
TEMPLATE_DIR=/site/${FQDN}/templates
STATIC_DIR=/site/${FQDN}/public
# Server
PORT=8080
DEBUG=false
CACHE_TTL_MINUTES=5
# Default user credentials (change after first login!)
DEFAULT_USER=admin
DEFAULT_PASS=your_secure_password
```
Secure the file:
```bash
sudo chmod 600 /site/${FQDN}/.env
sudo chown www-data:www-data /site/${FQDN}/.env
```
### 4. Install Systemd Service
```bash
# Copy and customize service file
sudo cp deployment/task-dashboard.service /etc/systemd/system/task-dashboard@.service
# Enable and start service
sudo systemctl daemon-reload
sudo systemctl enable task-dashboard@${FQDN}
sudo systemctl start task-dashboard@${FQDN}
# Check status
sudo systemctl status task-dashboard@${FQDN}
```
### 5. Configure Apache
```bash
# Enable required modules
sudo a2enmod proxy proxy_http ssl headers rewrite
# Copy and customize Apache config
# Replace ${FQDN} with your actual domain in the config file
sudo cp deployment/apache.conf /etc/apache2/sites-available/${FQDN}.conf
# Edit the file to replace ${FQDN} placeholders
sudo sed -i "s/\${FQDN}/${FQDN}/g" /etc/apache2/sites-available/${FQDN}.conf
# Enable site
sudo a2ensite ${FQDN}
# Test and reload
sudo apache2ctl configtest
sudo systemctl reload apache2
```
### 6. SSL Certificate (Let's Encrypt)
```bash
sudo apt install certbot python3-certbot-apache
sudo certbot --apache -d ${FQDN}
```
## Verification
1. Check service is running: `sudo systemctl status task-dashboard@${FQDN}`
2. Check logs: `sudo journalctl -u task-dashboard@${FQDN} -f`
3. Visit `https://${FQDN}` and login with configured credentials
## Updating
```bash
# Stop service
sudo systemctl stop task-dashboard@${FQDN}
# Deploy new binary
sudo cp app /site/${FQDN}/
# Update static assets if changed
sudo cp -r web/static/* /site/${FQDN}/public/
# Update templates if changed
sudo cp -r web/templates/* /site/${FQDN}/templates/
# Start service
sudo systemctl start task-dashboard@${FQDN}
```
## Troubleshooting
### Service won't start
- Check logs: `sudo journalctl -u task-dashboard@${FQDN} -e`
- Verify .env file exists and has correct permissions
- Ensure database directory is writable
### 502 Bad Gateway
- Check if Go app is running: `sudo systemctl status task-dashboard@${FQDN}`
- Verify PORT in .env matches Apache ProxyPass
### Static files not loading
- Ensure `/site/${FQDN}/public/` contains CSS/JS files
- Check Apache logs: `sudo tail -f /var/log/apache2/${FQDN}-error.log`
|
