Sanitized single-commit public mirror of recipe-maintainer. - Removed test-ssh/.testenv (live creds); added test-ssh/.testenv.example placeholders. - Removed plans/ and planned-updates/ (deployment-planning docs) so no client/ deployment domains appear in the public repo. - All other secret stores were already gitignored. - docs.coopcloud.tech retained as a submodule (public upstream).
44 lines
1.0 KiB
Markdown
44 lines
1.0 KiB
Markdown
# Custom HTML — First-Time Setup
|
|
|
|
## Prerequisites
|
|
|
|
- DNS: `custom-html.<DOMAIN_SUFFIX>` must resolve to the server
|
|
|
|
## Steps
|
|
|
|
1. **Create the app:**
|
|
```bash
|
|
abra app new custom-html --server <SERVER> --domain custom-html.<DOMAIN_SUFFIX> --no-input
|
|
```
|
|
|
|
2. **Deploy:**
|
|
```bash
|
|
abra app deploy custom-html.<DOMAIN_SUFFIX> --chaos --force --no-input
|
|
```
|
|
No secrets required.
|
|
|
|
3. **Copy your HTML content:**
|
|
```bash
|
|
abra app cp custom-html.<DOMAIN_SUFFIX> index.html app:/usr/share/nginx/html
|
|
```
|
|
|
|
4. **Verify:** curl `https://custom-html.<DOMAIN_SUFFIX>` returns HTTP 200.
|
|
|
|
## Optional: SSH/SFTP uploads
|
|
|
|
To allow SFTP file management, edit the app env file and uncomment:
|
|
```
|
|
COMPOSE_FILE="$COMPOSE_FILE:compose.sftp.yml"
|
|
PUBLIC_KEY="ssh-ed25519 AAAA... user@host"
|
|
```
|
|
Then redeploy. Connect via `ssh -p 2220 sftp@custom-html.<DOMAIN_SUFFIX>`.
|
|
|
|
## Optional: Git-pull from a repo
|
|
|
|
Uncomment in the env file:
|
|
```
|
|
COMPOSE_FILE="$COMPOSE_FILE:compose.git-pull.yml"
|
|
GIT_REPO_URL="https://..."
|
|
CRON_SCHEDULE="*/5 * * * *"
|
|
```
|