Installation

Quick Install

curl -fsSL https://raw.githubusercontent.com/hlop3z/astroladb/main/install.sh | sh

Go Install

If you have Go installed:

go install github.com/hlop3z/astroladb/cmd/alab@latest

Verify Installation

alab --version

You should see output like:

alab version 0.x.x

System Requirements

Requirement	Details
OS	Linux, macOS, Windows (WSL)
Database	PostgreSQL 12+ or SQLite 3.35+
Go (optional)	1.21+ (only for go install method)

The quick install script automatically detects your architecture and places the binary in /usr/local/bin.

Troubleshooting

Command Not Found

If alab is not found after installation:

1. Check if binary is in PATH:

   which alab

2. Add to PATH if needed:

   export PATH=$PATH:/usr/local/bin

3. For go install users: Ensure $GOPATH/bin is in your PATH:

   export PATH=$PATH:$(go env GOPATH)/bin

Permission Denied

If you get a permission error when running the install script:

# Run with sudo (Linux/macOS)
curl -fsSL https://raw.githubusercontent.com/hlop3z/astroladb/main/install.sh | sudo sh

Database Connection Issues

If migrations fail to connect:

1. Verify your database is running
2. Check connection string in alab.yaml
3. Test connection manually:

   # PostgreSQL
   psql "postgres://user:pass@localhost:5432/mydb"
   
   # SQLite
   sqlite3 ./dev.db

Next Steps

After installation, proceed to Quick Start to initialize your first project.