rbenv install 2.6.5)
Please refer to their installation guide.
For additional configuration options, check our PostgreSQL setup guide.
DEV uses ImageMagick to manipulate images on upload.
You can install ImageMagick with
brew install imagemagick.
DEV requires Redis version 4.0 or higher.
We recommend using Homebrew:
brew install redis
you can follow the post installation instructions, we recommend using
brew services to start Redis in the background:
brew services start redis
You can test if it's up and running by issuing the following command:
DEV requires Elasticsearch version 7 or higher.
We recommend installing from archive on Mac. The following directions were taken from the Elasticsearch docs themselves, so check those out if you run into any issues or want further information. Make sure to download the OSS version of Elasticsearch,
Please note that you will need
wget in order to proceed with this installation (
brew install wget).
1 2 3 4 5
wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-oss-7.5.2-darwin-x86_64.tar.gz wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-oss-7.5.2-darwin-x86_64.tar.gz.sha512 shasum -a 512 -c elasticsearch-oss-7.5.2-darwin-x86_64.tar.gz.sha512 tar -xzf elasticsearch-oss-7.5.2-darwin-x86_64.tar.gz cd elasticsearch-7.5.2/
To start elasticsearch:
To start elasticsearch as a daemonized process:
Clone your forked repository in one of two ways:
git clone https://github.com/<your-username>/dev.to.git
git clone email@example.com:<your-username>/dev.to.git
gem install bundler
Set up your environment variables/secrets
Envfileto see all the
ENVvariables we use and the fake default provided for any missing keys.
For any key that you wish to enter/replace, follow the steps below. At a minimum, you'll need to get your own free Algolia credentials to get your development environment running.
config/application.ymlby copying from the provided template (i.e. with bash:
cp config/sample_application.yml config/application.yml). This is a personal file that is ignored in git.
GITHUB_KEY: "SOME_REAL_SECURE_KEY_HERE" GITHUB_SECRET: "ANOTHER_REAL_SECURE_KEY_HERE"
ENVvariables on bootup, the envied gem will alert you with messages similar to
'error_on_missing_variables!': The following environment variables should be set: A_MISSING_KEY..
__NSPlaceholderDate initialize] may have been in progress in another thread when fork() was called
Solution: Run the command
export OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES (or
set -x OBJC_DISABLE_INITIALIZE_FORK_SAFETY YES in fish shell)
User does not have CONNECT privilege.
Solution: Complete the steps outlined in the PostgreSQL setup guide.
rbenv: version '<version number>' is not installed (set by /Path/To/Local/Repository/.ruby-version)
Solution: Run the command
rbenv install <version number>
ruby-build: definition not found: <version number> when
rbenv was installed via
1 2 3 4
ruby-build: definition not found: <version number> See all available versions with `rbenv install --list`. If the version you need is missing, try upgrading ruby-build:
Solution: Run the following to update
brew update && brew upgrade ruby-build. After that, rerun
rbenv install <version number> and that version will get installed.
1 2 3 4 5 6
== Preparing database == Sorry, you can't use byebug without Readline. To solve this, you need to rebuild Ruby with Readline support. If using Ubuntu, try `sudo apt-get install libreadline-dev` and then reinstall your Ruby. rails aborted! LoadError: dlopen(/Users/<username>/.rbenv/versions/2.6.5/lib/ruby/2.6.0/x86_64-darwin18/readline.bundle, 9): Library not loaded: /usr/local/opt/readline/lib/libreadline.<some version number>.dylib
ln -s /usr/local/opt/readline/lib/libreadline.dylib /usr/local/opt/readline/lib/libreadline.<some version number>.dylib from the command line then run
bin/setup again. You may have a different version of libreadline, so replace
<some version number> with the version that errored.
PG::Error: ERROR: invalid value for parameter "TimeZone": "UTC" : SET time zone 'UTC'
Solution: Restart your Postgres.app, or, if you installed PostgreSQL with Homebrew, restart with:
brew services restart postgresql
If that doesn't work, reboot your Mac.
1 2 3 4 5
ERROR: Error installing pg: ERROR: Failed to build gem native extension. [...] Can't find the 'libpq-fe.h header *** extconf.rb failed ***
Solution: You may encounter this when installing PostgreSQL with the Postgres.app. Try restarting the app and reinitializing the database. If that doesn't work, install PostgreSQL with Homebrew instead:
brew install postgresql
If you encountered any errors that you subsequently resolved, please consider updating this section with your errors and their solutions.