求助：如何在本地运行克隆的Helpy应用？解决依赖安装报错

Let’s walk through resolving the errors you’re facing to get Helpy running smoothly on your local machine.

1. Resolve the pg Gem Installation Failure #

The root block here is the pg gem failing to install, which stops Bundler from completing. This happens because the gem requires PostgreSQL development libraries to compile. Here’s how to fix it based on your OS:

For Ubuntu/Debian-based systems: #

• Install the required dependencies and PostgreSQL itself:

  sudo apt-get update && sudo apt-get install libpq-dev postgresql postgresql-contrib
  

• Start the PostgreSQL service:

  sudo systemctl start postgresql
  

  (You can enable it to start on boot with sudo systemctl enable postgresql)

For CentOS/RHEL-based systems: #

• Install PostgreSQL development tools and server:

  sudo yum install postgresql-devel postgresql-server
  

• Initialize and start the service:

  sudo postgresql-setup initdb
  sudo systemctl start postgresql
  

For macOS (using Homebrew): #

• Install PostgreSQL:

  brew install postgresql
  

• Start the service:

  brew services start postgresql
  

Once the dependencies are installed, install the specific pg gem version manually first:

gem install pg -v '0.18.4'

Verify this command completes without errors before moving on.

2. Complete Bundle Install & Fix Railties Missing Error #

Now that the pg gem is installed, run Bundler to install all required gems (including railties):

bundle install

This should resolve the "Could not find proper version of railties" error, since railties is listed in Helpy's Gemfile and Bundler will fetch it once dependencies are satisfied.

3. Configure Database & Initialize Helpy #

Before starting the Rails server, you need to set up your local database:

• Copy the example database config file:

  cp config/database.yml.example config/database.yml
  

• Open config/database.yml and adjust the settings to match your local PostgreSQL setup. For example:

  • If you’re using the default PostgreSQL user (postgres), make sure the username field is set to postgres.
  • If you set a password for the postgres user, add the password field with that value.
  • For local development, the database names (helpy_development, helpy_test) can stay as-is.

• Create the database and run migrations:

  rails db:create
  rails db:migrate
  

4. (Alternative) Use Docker for Easier Setup #

Since you already have Docker and docker-compose installed, this is often the simplest way to avoid environment dependency issues entirely:

• Navigate to your cloned Helpy directory.
• Start the application with Docker:

  docker-compose up --build
  

Docker will automatically pull all required images, set up PostgreSQL, and start the Helpy server. You can access it at http://localhost:3000 once the containers are running.

Once you’ve completed either the native setup or Docker setup, you should be able to access your local Helpy instance without issues.

内容的提问来源于stack exchange，提问作者Shruthi R