Simplify README for Coolify deployment
This commit is contained in:
parent
8eee773b37
commit
ecf9d62dc3
1 changed files with 33 additions and 80 deletions
|
|
@ -1,82 +1,59 @@
|
|||
# PicoClaw Coolify Deployment
|
||||
# PicoClaw on Coolify
|
||||
|
||||
Deploy PicoClaw on Coolify with persistent storage and easy configuration editing.
|
||||
|
||||
## Quick Start
|
||||
## How it works
|
||||
|
||||
### 1. Configuration
|
||||
- Init container runs `picoclaw onboard` to create config + workspace
|
||||
- Gateway container runs the bot
|
||||
- Data persists via bind mount
|
||||
|
||||
Edit `docker-compose.coolify.yml` to set the desired port:
|
||||
## Change bind folder & port
|
||||
|
||||
Edit `docker-compose.coolify.yml`:
|
||||
|
||||
```yaml
|
||||
services:
|
||||
picoclaw-init:
|
||||
volumes:
|
||||
- /YOUR/PATH/:/root/.picoclaw
|
||||
|
||||
picoclaw-gateway:
|
||||
volumes:
|
||||
- /YOUR/PATH/:/root/.picoclaw
|
||||
ports:
|
||||
- "${HOST_PORT:-18790}:18790"
|
||||
- "YOUR_PORT:18790"
|
||||
```
|
||||
|
||||
Change `HOST_PORT` to your desired port (e.g., `18800:18790`).
|
||||
Replace:
|
||||
- `/YOUR/PATH/` - your folder path (e.g., `/home/lou/Dev/apps/picoclaw/`)
|
||||
- `YOUR_PORT` - your desired port (e.g., `18800`)
|
||||
|
||||
### 2. Persistent Storage (Bind Mount)
|
||||
## Deploy
|
||||
|
||||
In Coolify UI, add a persistent storage:
|
||||
1. Create folder on server: `mkdir -p /YOUR/PATH/`
|
||||
2. In Coolify: Add Docker Compose resource
|
||||
3. Paste `docker-compose.coolify.yml`
|
||||
4. Add persistent storage:
|
||||
- Type: Bind Mount
|
||||
- Source: `/YOUR/PATH/`
|
||||
- Destination: `/root/.picoclaw`
|
||||
5. Deploy
|
||||
6. Edit config at `/YOUR/PATH/config.json`
|
||||
|
||||
- **Type:** Bind Mount
|
||||
- **Source Path:** `/apps/picoclaw/`
|
||||
- **Destination Path:** `/root/.picoclaw`
|
||||
|
||||
### 3. Deploy
|
||||
|
||||
Deploy from Coolify. The init container will run `picoclaw onboard` on first run, creating:
|
||||
- `config.json`
|
||||
- `workspace/` (AGENTS.md, SOUL.md, MEMORY.md, USER.md)
|
||||
- `sessions/`
|
||||
- `skills/`
|
||||
|
||||
## Editing Configuration
|
||||
## Edit Config
|
||||
|
||||
### Via SSH
|
||||
|
||||
```bash
|
||||
nano /apps/picoclaw/config.json
|
||||
nano /YOUR/PATH/config.json
|
||||
```
|
||||
|
||||
### Via VSCodium
|
||||
### Via VSCodium/VSCode
|
||||
|
||||
1. Install Remote-SSH extension
|
||||
2. Connect to server: `ssh user@your-server`
|
||||
3. Open folder: `/apps/picoclaw/`
|
||||
|
||||
### Via VSCode
|
||||
|
||||
Same as VSCodium - use Remote SSH extension.
|
||||
|
||||
## File Structure
|
||||
|
||||
After first run, the data folder contains:
|
||||
|
||||
```
|
||||
/apps/picoclaw/
|
||||
├── config.json # Main configuration (edit this!)
|
||||
├── workspace/ # Agent workspace
|
||||
│ ├── AGENTS.md # Agent instructions
|
||||
│ ├── SOUL.md # Personality/beliefs
|
||||
│ ├── MEMORY.md # Long-term memory
|
||||
│ ├── USER.md # User preferences
|
||||
│ └── skills/ # Installed skills
|
||||
├── sessions/ # Session history
|
||||
└── skills/ # Global skills
|
||||
```
|
||||
|
||||
## Configuration
|
||||
|
||||
Edit `config.json` to configure:
|
||||
- Model provider (OpenAI, Anthropic, DeepSeek, etc.)
|
||||
- Channels (Telegram, Discord, WhatsApp, QQ, etc.)
|
||||
- Tools (web search, exec, cron, MCP)
|
||||
- Agent defaults
|
||||
|
||||
See `config/config.example.json` in the project root for full reference.
|
||||
3. Open folder: `/YOUR/PATH/`
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
|
|
@ -86,28 +63,4 @@ Check logs: `docker logs picoclaw-gateway`
|
|||
|
||||
### Config not being read
|
||||
|
||||
Ensure bind mount path `/apps/picoclaw/` is correctly set in Coolify persistent storage.
|
||||
|
||||
### Port already in use
|
||||
|
||||
Edit `docker-compose.coolify.yml` and change the port mapping.
|
||||
|
||||
## Example Coolify Setup
|
||||
|
||||
```
|
||||
Persistent Storage:
|
||||
- Source: /apps/picoclaw/
|
||||
- Destination: /root/.picoclaw
|
||||
- Type: Bind Mount
|
||||
```
|
||||
|
||||
## Building from Source (Optional)
|
||||
|
||||
If you need to build your own image:
|
||||
|
||||
```bash
|
||||
cd picoclaw
|
||||
docker build -f docker/Dockerfile -t my-picoclaw:latest .
|
||||
```
|
||||
|
||||
Then update `docker-compose.coolify.yml` to use `my-picoclaw:latest`.
|
||||
Ensure bind mount path is correctly set in Coolify persistent storage.
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue