Skip to main content
Documentation Setup Installation Guides

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 #

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

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

sudo dnf update
sudo dnf install nodejs nodejs-devel

Then verify your installed versions:

node -v
> v20.x

Install Bridgetown #

Now all that is left is to install Bridgetown!

gem install bridgetown -N -v 2.0.0.beta2

Create a new Bridgetown site at ./mysite, as well as run bundle install and npm 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 Guides