The easiest way to get started with OpnForm is through our official managed service in the Cloud. It takes just 1 minute to try out the builder for free, with high availability, backups, security, and maintenance all managed for you.
Looking to develop OpnForm locally? Check out our Docker Development Setup guide which provides hot-reload and other development features.
Important for Windows Users: Ensure script files maintain LF (Unix-style) line endings. If you’re using Windows, configure Git to preserve line endings:
Copy
git config core.autocrlf false
And check/fix the artisan script before running setup:
Copy
# Using Git Bash or WSLdos2unix api/artisan
Otherwise, Docker containers may hang at “Waiting for DB to be ready” during startup.
# Check database statusdocker compose exec db pg_isready# View database logsdocker compose logs db
If the API container is stuck on “Waiting for DB to be ready”:
Copy
# Check for line ending issues in the artisan script# The file should use LF (Unix) line endings, not CRLF (Windows)# Fix line endings on Unix/Mac:sed -i 's/\r$//' api/artisan# Fix line endings on Windows (using Git Bash or WSL):dos2unix api/artisan
Line Ending Issue: When using Git or code editors on Windows, line endings in the artisan script may be converted from LF (Unix-style) to CRLF (Windows-style). This prevents the Docker container from properly executing the script, causing it to hang at “Waiting for DB to be ready”. Always ensure script files maintain LF line endings.