Omakub for Ubuntu
https://omakub.org/ is great and after installing ubuntu on my machine, the first thing I do is install omakub, this setup Dev environment with different softwares, Docker, etc. Check https://omakub.org/ for more information.
LazyVim
https://www.lazyvim.org/ - This is really awesome IDE for neovim, if you are a vim user. Otherwise go with Vscode.
1. Install Ruby, nodejs and Postgresql
It uses mise, but you can use asdf. Because these tools helps you install different versions of ruby, node from single tools. If your system is already using different plugin manager for different tools e.g: rbenv for ruby and nvm for node, you are good as well.
Install Ruby, nodejs and Postgresql using https://gorails.com/setup/ubuntu/24.04
- make sure to install following versions:
ruby: 3.1.6
rails: 6.1.7.6
postgresql: latest (should work), upto version 15 is tested.
nodejs: 16.16.0 (use this exact version)
And also install `npm install -g yarn` because rails uses `yarn` package manager.
2. Install Elastic search
- If you are using docker, you can simply use:
docker start elesticsearch_7 || docker run -d --name elesticsearch_7 -p 9200:9200 -e \"http.host=0.0.0.0\" -e \"transport.host=127.0.0.1\" docker.elastic.co/elasticsearch/elasticsearch:7.10.1
And your elastic search should be setup for the project. Otherwise you can install elastic search in your system depending on OS e.g: brew install [email protected] or using apt get install ....
3. Install Redis
Install redis using https://redis.io/docs/latest/operate/oss_and_stack/install/install-redis/ for os of your choice
4. Imagemagick
ubuntu
sudo apt-get install imagemagick
macos
brew install imagemagick
5. Once all the dependencies are installed, You can clone the project and install required dev dependencies:
git clone [email protected]:<appname>.git
cd <my-app>
bundle install
copy config/database.yml and adjust the username and password if needed. If you followed https://gorails.com/setup/macos/15-sequoia postgresql installation, you should have created your system user in your database, which don't require you to enter password to access the DB. In anycase, change your host, username and password depending on how you installed postgresql (e.g: docker has different host).
cp config/database.sample.yml config/database.yml
copy config variables, or .env files depending on your project’s requirement.
touch config/application.yml
And ask for credentials from DEV.
Final step
Once all the dependencies are installed and project is setup correctly, we can create database and generate database migration and start using application with:
NOTE: make sure to run rails db:schema:load If there are corrupted migrations in the project.
cd <my-app>
rails db:create
rails db:schema:load
rails db:migrate
rails db:seed
Run the project
run these scripts in different terminal tabs or windows:
rails app
bin/setup
rails server
sidekiq
bundle exec sidekiq
and visit http://localhost:3000
If everything is setup correctly, your app should work.
Setup stripe (if you are using them)
Because you can't access our app without trial payment, you need to run the stripe webhooks to add subscriptions, to setup stripe follow:
One time steps:
stripe login
To listen to stripe webhooks
stripe listen --forward-to localhost:3000/pay/webhooks/stripe
Ultrahook or Ngrok as a Dev webhooks listeners
