mirror of https://github.com/seanmorley15/AdventureLog.git synced 2026-07-30 23:38:02 -04:00

Files

Sean Morley 4cd6ab4fd2 Refactor Docker Compose files and update documentation

- Commented out build configurations in docker-compose files for AIO, dev, and standard setups to simplify deployment.
- Updated the documentation homepage with a new layout, including a hero section, features overview, and installation options.
- Introduced new Vue components for enhanced user experience on the documentation site, including HomeHero, HomeFeatures, and HomeInstall.
- Improved SEO metadata for better visibility and searchability of the documentation.

2026-06-06 21:42:05 -04:00

2.6 KiB

Raw Blame History

Quick Start Installer

Install AdventureLog in seconds with the official curl installer. It defaults to the All-in-One (AIO) layout — one URL, one port, minimal configuration — and includes a management menu for updates and backups.

One-line install

curl -sSL https://get.adventurelog.app | bash

What the installer does

Checks dependencies (Docker, Compose v2, RAM, CPU architecture)
Detects ARM hosts and configures a compatible PostGIS image automatically
Creates the ./adventurelog project directory (configurable via INSTALL_DIR)
Downloads docker-compose.aio.yml or docker-compose.yml, env files, and management scripts
Walks you through site URL, admin credentials, and optional features (S3, email, integrations)
Starts containers and waits for the /health endpoint
Saves credentials to credentials.txt when generated

Requirements

Requirement	Details
Docker + Compose v2	Required
RAM	2 GB recommended on first boot; ~1 GB afterward
OS	Linux server, VPS, or macOS with Docker Desktop
Domain	Optional — set `SITE_URL` for HTTPS behind a reverse proxy

::: tip ARM / Apple Silicon The installer automatically uses imresamu/postgis:16-3.5-alpine on ARM hosts. AdventureLog images are multi-arch. :::

Setup modes

During installation you can choose:

Mode	Compose file	Env file	When to use
All-in-One (default)	`docker-compose.aio.yml`	`.env.aio`	Simplest — one port, auto-derived URLs
Standard	`docker-compose.yml`	`.env`	Full env control, separate frontend/backend ports

Re-run the installer when an install already exists:

curl -sSL https://get.adventurelog.app | bash
# or from the install directory:
bash install_adventurelog.sh --manage

Options include status, update, reconfigure, backup, restore, logs, restart, and uninstall. See Operations & Maintenance.

Dry run

Preview what the installer would do without making changes:

ADVENTURELOG_SKIP_GUM=1 bash install_adventurelog.sh --dry-run --force-install

Uninstall

From the management menu, choose Uninstall, or manually:

cd adventurelog
docker compose --env-file .env.aio -f docker-compose.aio.yml down -v
rm -rf adventurelog

Next steps

All-in-One Docker — how the AIO container works
Standard Docker — multi-container configuration
Environment Variables — full reference
Other install options

2.6 KiB Raw Blame History