Rubyists Assemble! We're currently raising funds to help drive the launch of 1.0! Join the effort today ▸

Bridgetown on Fedora

Install Ruby

Using Rbenv

Update your package list:

Then install dependencies:

sudo dnf install git-core zlib zlib-devel gcc-c++ patch readline readline-devel libyaml-devel libffi-devel openssl-devel make bzip2 autoconf automake libtool bison curl sqlite-devel

Install rbenv

git clone https://github.com/rbenv/rbenv.git ~/.rbenv
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
source ~/.bashrc

Install ruby-build to provide rbenv install

git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
echo 'export PATH="$HOME/.rbenv/plugins/ruby-build/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Then install Ruby and check the version

rbenv install 3.0.2
rbenv global 3.0.2

ruby -v
> ruby 3.0.2p107 (2021-07-07 revision 0db68f0233) [x86_64-linux]

gem install bundler -N

Check the rbenv command reference for more information here

Using Fedora Repositories

Fedora typically uses a recent version of Ruby that is maintained by the Fedora Ruby special interest group.

First, update your package list:

sudo dnf update

Then install Ruby as indicated here using

sudo dnf install ruby

Verify that ruby is installed

ruby -v
> ruby 2.6.6p146 (2020-03-31 revision 67876) [x86_64-linux]

Then install bundler as indicated here

gem install bundler

And that’s it!

Install Node & Yarn

Node is a JavaScript runtime that can execute on a server or development machine. Yarn is a package manager for Node packages. You’ll need Node and Yarn in order to install and use Webpack, the frontend asset compiler that runs alongside Bridgetown.

The easiest way to install Node and Yarn is via the package manager dnf.

sudo dnf update
sudo dnf install nodejs nodejs-devel
sudo dnf install nodejs-yarn

Then verify your installed versions:

node -v
> v12.19.0
yarn -v
> 1.21.1

Install Bridgetown

Now all that is left is to install Bridgetown!

gem install bridgetown -N -v 1.0.0.alpha11

Create a new Bridgetown site at ./mysite, as well as run bundle install and yarn install automatically:

bridgetown new mysite

cd mysite

Now you should be able to build the site and run a live-reload server:

$ bin/bridgetown start

Try opening the site up in http://localhost:4000. See something? Awesome, you’re ready to roll! If not, try revisiting your installation and setup steps, and if all else fails, reach out to the Bridgetown community for support.

Back to Installation