Docker Deployment

TryPost includes Laravel Sail, a lightweight Docker development environment.

Requirements

  • Docker Desktop (Mac, Windows) or Docker Engine (Linux)
  • Docker Compose

Quick Start

1. Clone the repository 

git clone https://github.com/trypost-it/trypost.git
cd trypost

2. Install Composer dependencies

You can use a temporary container to install dependencies without PHP on your host:

docker run --rm \
    -u "$(id -u):$(id -g)" \
    -v "$(pwd):/var/www/html" \
    -w /var/www/html \
    laravelsail/php84-composer:latest \
    composer install --ignore-platform-reqs

3. Configure environment 

cp .env.example .env

Update your .env for Docker:

APP_URL=http://localhost

DB_CONNECTION=pgsql
DB_HOST=pgsql
DB_PORT=5432
DB_DATABASE=trypost
DB_USERNAME=sail
DB_PASSWORD=password

REDIS_HOST=redis

4. Generate the Docker Compose file 

php artisan sail:install

Select the services you need:

  • pgsql - PostgreSQL database (recommended)
  • redis - Required for queues and caching
  • meilisearch - Optional, for search functionality

5. Start the containers 

./vendor/bin/sail up -d

6. Generate application key 

./vendor/bin/sail artisan key:generate

7. Run migrations 

./vendor/bin/sail artisan migrate

8. Build frontend assets 

./vendor/bin/sail npm install
./vendor/bin/sail npm run build

Accessing TryPost

Once running, access TryPost at: http://localhost

Common Commands 

# Start containers
./vendor/bin/sail up -d

# Stop containers
./vendor/bin/sail down

# View logs
./vendor/bin/sail logs

# Run Artisan commands
./vendor/bin/sail artisan <command>

# Run npm commands
./vendor/bin/sail npm <command>

# Access PostgreSQL
./vendor/bin/sail psql

# Access Redis CLI
./vendor/bin/sail redis

Running the Queue Worker

For background job processing:

./vendor/bin/sail artisan horizon

Or run it in a separate terminal:

./vendor/bin/sail up -d
./vendor/bin/sail artisan horizon

Shell Alias

Add this alias to your shell profile (~/.bashrc, ~/.zshrc):

alias sail='./vendor/bin/sail'

Then you can use:

sail up -d
sail artisan migrate
sail npm run dev

Production with Docker

For production deployments with Docker, you’ll want to:

  1. Use a production-ready Docker Compose configuration
  2. Set APP_ENV=production and APP_DEBUG=false
  3. Use proper SSL termination (nginx, Traefik, etc.)
  4. Configure persistent volumes for storage
  5. Set up proper logging and monitoring

See the Production Setup guide for more details on production configurations.

Troubleshooting

Port conflicts

If port 80 is already in use, change the APP_PORT in .env:

APP_PORT=8080

Permission issues

On Linux, you may need to run:

sudo chown -R $USER: .

Database connection refused

Make sure the database container is running:

./vendor/bin/sail ps

Wait a few seconds after starting for the database to initialize.