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 esbuild, 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
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.