mirror of
https://github.com/memohai/Memoh.git
synced 2026-04-27 07:16:19 +09:00
Acbox
84 lines
2.1 KiB
Markdown
84 lines
2.1 KiB
Markdown
# Memoh Deployment Guide
|
|
|
|
## One-Click Install
|
|
|
|
```bash
|
|
curl -fsSL https://memoh.sh | sudo sh
|
|
```
|
|
|
|
Or manually:
|
|
|
|
```bash
|
|
git clone https://github.com/memohai/Memoh.git
|
|
cd Memoh
|
|
sudo docker compose up -d
|
|
```
|
|
|
|
> On macOS or if your user is in the `docker` group, `sudo` is not required.
|
|
|
|
Access:
|
|
- Web UI: http://localhost:8082
|
|
- API: http://localhost:8080
|
|
- Agent: http://localhost:8081
|
|
|
|
Default credentials: `admin` / `admin123`
|
|
|
|
## Prerequisites
|
|
|
|
- Docker (with Docker Compose v2)
|
|
- Git
|
|
|
|
That's it. No containerd, nerdctl, or buildkit required on the host.
|
|
|
|
## Custom Configuration
|
|
|
|
By default, Docker Compose uses `conf/app.docker.toml` (no file in project root is mounted; only this config file is mounted into the containers).
|
|
|
|
To use your own config, create and edit it in the project root, then point `MEMOH_CONFIG` at it (path is on the host; run `docker compose` from the project root):
|
|
|
|
```bash
|
|
cp conf/app.docker.toml config.toml
|
|
nano config.toml
|
|
sudo MEMOH_CONFIG=./config.toml docker compose up -d
|
|
```
|
|
|
|
Recommended changes for production:
|
|
- `admin.password` - Admin password
|
|
- `auth.jwt_secret` - JWT secret (generate with `openssl rand -base64 32`)
|
|
- `postgres.password` - Database password
|
|
|
|
## Common Commands
|
|
|
|
> Prefix with `sudo` on Linux if your user is not in the `docker` group.
|
|
|
|
```bash
|
|
docker compose up -d # Start
|
|
docker compose down # Stop
|
|
docker compose logs -f # View logs
|
|
docker compose ps # Status
|
|
docker compose up -d --build # Rebuild and restart
|
|
```
|
|
|
|
## Production
|
|
|
|
1. Configure HTTPS (create `docker-compose.override.yml` with SSL certs)
|
|
2. Change all default passwords
|
|
3. Configure firewall
|
|
4. Set resource limits
|
|
5. Regular backups
|
|
|
|
## Troubleshooting
|
|
|
|
```bash
|
|
docker compose logs server # View service logs
|
|
docker compose logs containerd # View containerd logs
|
|
docker compose config # Check configuration
|
|
docker compose build --no-cache && docker compose up -d # Full rebuild
|
|
```
|
|
|
|
## Security Warnings
|
|
|
|
- Main service has privileged container access - only run in trusted environments
|
|
- Must change all default passwords and secrets
|
|
- Use HTTPS in production
|